UIElement.OnRender(DrawingContext) Methode

Definition

Namespace:
System.Windows
Assembly:
PresentationCore.dll

Wenn sie in einer abgeleiteten Klasse überschrieben werden, nehmen Sie an Renderingvorgängen teil, die vom Layoutsystem geleitet werden. Die Renderinganweisungen für dieses Element werden nicht direkt verwendet, wenn diese Methode aufgerufen wird, und werden stattdessen für die spätere asynchrone Verwendung durch Layout und Zeichnung beibehalten.

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)

Parameter

drawingContext
DrawingContext

Die Zeichenanweisungen für ein bestimmtes Element. Dieser Kontext wird dem Layoutsystem bereitgestellt.

Beispiele

Das folgende Codebeispiel zeigt eine mögliche Implementierung für eine von einem Panel abgeleitete Klasse.

// 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

Hinweise

Diese Methode hat keine Standardimplementierung in der UIElement Klasse.

Hinweise für Vererber

Die OnRender(DrawingContext) Methode kann überschrieben werden, um einem gerenderten Element weitere grafische Elemente (zuvor nicht in einer logischen Struktur definiert) hinzuzufügen, z. B. Effekte oder Schmücken. Ein DrawingContext Objekt wird als Argument übergeben, das Methoden zum Zeichnen von Formen, Text, Bildern oder Videos bereitstellt.

Gilt für: