UIElement.OnRender(DrawingContext) Metod

Definition

Namnområde:
System.Windows
Sammansättning:
PresentationCore.dll

När den åsidosätts i en härledd klass deltar i renderingsåtgärder som dirigeras av layoutsystemet. Återgivningsinstruktionerna för det här elementet används inte direkt när den här metoden anropas och bevaras i stället för senare asynkron användning av layout och ritning.

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)

Parametrar

drawingContext
DrawingContext

Ritningsinstruktionerna för ett visst element. Den här kontexten tillhandahålls till layoutsystemet.

Exempel

I följande kodexempel visas en möjlig implementering för en panel härledd klass.

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

Kommentarer

Den här metoden har ingen standardimplementering i UIElement klassen.

Anteckningar till arvingar

Metoden OnRender(DrawingContext) kan åsidosättas för att lägga till ytterligare grafiska element (som inte tidigare definierats i ett logiskt träd) till ett renderat element, till exempel effekter eller utsmyckningar. Ett DrawingContext objekt skickas som ett argument som innehåller metoder för att rita former, text, bilder eller videor.

Gäller för