UIElement.OnRender(DrawingContext) UIElement.OnRender(DrawingContext) UIElement.OnRender(DrawingContext) Method

Definición

Si se reemplaza en una clase derivada, participa en operaciones de representación que están dirigidas por el sistema de diseño.When overridden in a derived class, participates in rendering operations that are directed by the layout system. 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.The rendering instructions for this element are not used directly when this method is invoked, and are instead preserved for later asynchronous use by layout and drawing.

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

Parámetros

drawingContext
DrawingContext DrawingContext DrawingContext

Instrucciones de dibujo para un elemento concreto.The drawing instructions for a specific element. Este contexto se proporciona al sistema de diseño.This context is provided to the layout system.

Ejemplos

En el ejemplo de código siguiente se muestra una posible implementación para una clase derivada de panel.The following code example shows a possible implementation for a panel derived class.

// 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 UIElement la clase.This method has no default implementation in the UIElement class.

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.The OnRender(DrawingContext) method can be overridden to add further graphical elements (not previously defined in a logical tree) to a rendered element, such as effects or adorners. Un DrawingContext objeto se pasa como argumento, que proporciona métodos para dibujar formas, texto, imágenes o vídeos.A DrawingContext object is passed as an argument, which provides methods for drawing shapes, text, images or videos.

Se aplica a