UIElement.OnRender(DrawingContext) Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

In caso di override in una classe derivata, partecipa alle operazioni di rendering gestite dal sistema di layout. Le istruzioni di rendering per questo elemento non vengono utilizzate direttamente quando questo metodo viene richiamato, ma vengono conservate per essere utilizzate successivamente in modo asincrono dal layout e dal 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 per il sistema di layout.

Esempio

Nell'esempio di codice seguente viene illustrata una possibile implementazione per una classe derivata dal 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 alcuna implementazione predefinita nella UIElement classe.

Note per gli eredi

Il OnRender(DrawingContext) metodo può essere sottoposto a override per aggiungere altri elementi grafici (non definiti in precedenza in un albero logico) a un elemento di cui è stato eseguito il rendering, ad esempio effetti o adornatori. Un DrawingContext oggetto viene passato come argomento, che fornisce metodi per il disegno di forme, testo, immagini o video.