UIElement.OnRender(DrawingContext) UIElement.OnRender(DrawingContext) UIElement.OnRender(DrawingContext) Method

Definizione

In caso di override in una classe derivata, partecipa alle operazioni di rendering gestite dal sistema di layout.When overridden in a derived class, participates in rendering operations that are directed by the layout system. 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.The rendering instructions for this element are not used directly when this method is invoked, and are instead preserved for later asynchronous use by layout and drawing.

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

Parametri

drawingContext
DrawingContext DrawingContext DrawingContext

Istruzioni di disegno per un elemento specifico.The drawing instructions for a specific element. Questo contesto viene fornito per il sistema di layout.This context is provided to the layout system.

Esempi

Nell'esempio di codice riportato di seguito viene illustrata una possibile implementazione di una classe derivata Panel.The following code example shows a possible implementation for a panel derived class.

// 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.This method has no default implementation in the UIElement class.

Note per gli eredi

È OnRender(DrawingContext) possibile eseguire l'override del metodo 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 Adorner.The OnRender(DrawingContext) method can be overridden to add further graphical elements (not previously defined in a logical tree) to a rendered element, such as effects or adorners. Un DrawingContext oggetto viene passato come argomento, che fornisce metodi per disegnare forme, testo, immagini o video.A DrawingContext object is passed as an argument, which provides methods for drawing shapes, text, images or videos.

Si applica a