UIElement.OnRender(DrawingContext) Methode

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Beteiligt sich beim Überschreiben in einer abgeleiteten Klasse an Rendervorgängen, die vom Layoutsystem gesteuert werden. Die Renderinganweisungen für dieses Element werden beim Aufrufen dieser Methode nicht direkt verwendet, sondern stattdessen für spätere asynchrone Layout- und Zeichnungsvorgänge 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 Zeichnungsanweisungen für ein bestimmtes Element. Dieser Kontext wird für das Layoutsystem bereitgestellt.

Beispiele

Das folgende Codebeispiel zeigt eine mögliche Implementierung für eine vom 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 verfügt über keine Standardimplementierung in der UIElement -Klasse.

Hinweise für Vererber

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

Gilt für:

Produkt	Versionen
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Freigeben über