UIElement.OnRender(DrawingContext) Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Cuando se invalida en una clase derivada, participa en las operaciones de representación dirigidas por el sistema de diseño. Las instrucciones de representación de este elemento no se usan directamente cuando se invoca este método y, en su lugar, se conservan para su uso asincrónico posterior mediante diseño y dibujo.

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)

Parámetros

drawingContext

DrawingContext

Las instrucciones de dibujo de un elemento específico. Este contexto se proporciona al sistema de diseño.

Ejemplos

En el ejemplo de código siguiente se muestra una posible implementación para una clase derivada del panel.

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

Comentarios

Este método no tiene ninguna implementación predeterminada en la UIElement clase .

Notas a los desarrolladores de herederos

El OnRender(DrawingContext) método se puede invalidar para agregar elementos gráficos adicionales (no definidos previamente en un árbol lógico) a un elemento representado, como efectos o adornos. Se DrawingContext pasa un objeto como argumento, que proporciona métodos para dibujar formas, texto, imágenes o vídeos.