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.

C#

protected virtual void OnRender (System.Windows.Media.DrawingContext 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.

C#

// 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);
}

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.

Se aplica a