UIElement.OnRender(DrawingContext) Metódus

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationCore.dll

Ha egy származtatott osztályban felül van bírálva, részt vesz az elrendezési rendszer által irányított renderelési műveletekben. Az elem renderelési utasításait a rendszer nem használja közvetlenül a metódus meghívásakor, hanem az elrendezés és a rajz későbbi aszinkron használatára megőrzi őket.

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)

Paraméterek

drawingContext

DrawingContext

Egy adott elem rajzi utasításai. Ezt a környezetet az elrendezési rendszer biztosítja.

Példák

Az alábbi példakód egy panelből származtatott osztály lehetséges implementációját mutatja be.

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

Megjegyzések

Ez a metódus nem rendelkezik alapértelmezett implementációval az UIElement osztályban.

Megjegyzések az öröklőkhöz

A OnRender(DrawingContext) metódus felülírható további grafikus elemek (korábban nem logikai fában definiált) renderelt elemekhez, például effektusokhoz vagy díszítőelemekhez való hozzáadásához. A DrawingContext rendszer argumentumként ad át egy objektumot, amely metódusokat biztosít alakzatok, szövegek, képek vagy videók rajzoláshoz.