UIElement.OnRender(DrawingContext) Metoda

Definicja

Po zastąpieniu klasy pochodnej uczestniczy w operacjach renderowania, które są kierowane przez system układu. Instrukcje renderowania dla tego elementu nie są używane bezpośrednio w przypadku wywołania tej metody i są zamiast tego zachowywane na potrzeby późniejszego asynchronicznego użycia przez układ i rysunek.

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

Instrukcje dotyczące rysunku dla określonego elementu. Ten kontekst jest dostarczany do systemu układu.

Przykłady

Poniższy przykład kodu przedstawia możliwą implementację klasy pochodnej 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

Uwagi

Ta metoda nie ma domyślnej implementacji UIElement w klasie.

Uwagi dotyczące dziedziczenia

Metodę OnRender(DrawingContext) można zastąpić, aby dodać kolejne elementy graficzne (niezdefiniowane wcześniej w drzewie logicznym) do renderowanego elementu, takiego jak efekty lub adornery. DrawingContext Obiekt jest przekazywany jako argument, który udostępnia metody rysowania kształtów, tekstu, obrazów lub filmów wideo.

Dotyczy