UIElement.OnRender(DrawingContext) Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Si se reemplaza en una clase derivada, participa en operaciones de representación que están dirigidas por el sistema de diseño. Las instrucciones de representación para este elemento no se usan directamente cuando se invoca este método, en su lugar se conservan para el uso asincrónico posterior por parte del diseño y el 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

Instrucciones de dibujo para un elemento concreto. Este contexto se proporciona al sistema de diseño.

Ejemplos

En el ejemplo de código siguiente se muestra una posible implementación de 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 más elementos gráficos (no definidos previamente en un árbol lógico) a un elemento representado, como efectos o adornos. Un DrawingContext objeto se pasa como argumento, que proporciona métodos para dibujar formas, texto, imágenes o vídeos.