UIElement.OnRender(DrawingContext) Metodo

Definizione

Spazio dei nomi:
System.Windows
Assembly:
PresentationCore.dll

Quando sottoposto a override in una classe derivata, partecipa alle operazioni di rendering dirette dal sistema di layout. Le istruzioni di rendering per questo elemento non vengono usate direttamente quando questo metodo viene richiamato e vengono mantenute per un uso asincrono successivo da parte del layout e del disegno.

protected:
 virtual void OnRender(System::Windows::Media::DrawingContext ^ drawingContext);
protected virtual void OnRender(System.Windows.Media.DrawingContext drawingContext);
abstract member OnRender : System.Windows.Media.DrawingContext -> unit
override this.OnRender : System.Windows.Media.DrawingContext -> unit
Protected Overridable Sub OnRender (drawingContext As DrawingContext)

Parametri

drawingContext
DrawingContext

Istruzioni di disegno per un elemento specifico. Questo contesto viene fornito al sistema di layout.

Esempio

Nell'esempio di codice seguente viene illustrata una possibile implementazione per una classe derivata da un pannello.

// Override the OnRender call to add a Background and Border to the OffSetPanel
protected override void OnRender(DrawingContext dc)
{
    SolidColorBrush mySolidColorBrush  = new SolidColorBrush();
    mySolidColorBrush.Color = Colors.LimeGreen;
    Pen myPen = new Pen(Brushes.Blue, 10);
    Rect myRect = new Rect(0, 0, 500, 500);
    dc.DrawRectangle(mySolidColorBrush, myPen, myRect);
}

' Override the OnRender call to add a Background and Border to the OffSetPanel
Protected Overrides Sub OnRender(ByVal dc As DrawingContext)
    Dim mySolidColorBrush As New SolidColorBrush()
    mySolidColorBrush.Color = Colors.LimeGreen
    Dim myPen As New Pen(Brushes.Blue, 10)
    Dim myRect As New Rect(0, 0, 500, 500)
    dc.DrawRectangle(mySolidColorBrush, myPen, myRect)
End Sub

Commenti

Questo metodo non ha un'implementazione predefinita nella UIElement classe .

Note per gli eredi

È possibile eseguire l'override del OnRender(DrawingContext) metodo per aggiungere altri elementi grafici (non definiti in precedenza in un albero logico) a un elemento sottoposto a rendering, ad esempio effetti o strumenti decorativi. Un DrawingContext oggetto viene passato come argomento, che fornisce metodi per disegnare forme, testo, immagini o video.

Si applica a