UIElement.OnRender(DrawingContext) Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Při přepsání v odvozené třídě se účastní operací vykreslování, které jsou směrovány systémem rozložení. Pokyny pro vykreslování pro tento prvek nejsou použity přímo při vyvolání této metody a místo toho jsou zachovány pro pozdější asynchronní použití rozložením a výkresem.

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)

Parametry

drawingContext

DrawingContext

Pokyny k kreslení pro určitý prvek. Tento kontext je k dispozici systému rozložení.

Příklady

Následující příklad kódu ukazuje možnou implementaci pro odvozenou třídu panelu.

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

Poznámky

Tato metoda nemá ve UIElement třídě žádnou výchozí implementaci.

Poznámky pro dědice

Metodu OnRender(DrawingContext) lze přepsat a přidat další grafické prvky (nikoli dříve definované v logickém stromu) do vykresleného prvku, jako jsou efekty nebo doplňky. Objekt DrawingContext se předává jako argument, který poskytuje metody pro kreslení obrazců, textu, obrázků nebo videí.