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

Определение

При переопределении в производном классе участвует в операциях отрисовки, направляемых системой макета.When overridden in a derived class, participates in rendering operations that are directed by the layout system. Инструкции отрисовки для данного элемента не используются непосредственно при вызове данного метода, а вместо этого сохраняются для последующего асинхронного использования при структурировании и рисовании.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

Параметры

drawingContext
DrawingContext DrawingContext DrawingContext

Инструкции по рисованию конкретного элемента.The drawing instructions for a specific element. Данный контекст предоставляется системе структуры.This context is provided to the layout system.

Примеры

В следующем примере кода показана возможная реализация для производного класса панели.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

Комментарии

Этот метод не имеет значение по умолчанию реализации UIElement класса.This method has no default implementation in the UIElement class.

Примечания для тех, кто наследует этот метод

OnRender(DrawingContext) Метод может быть переопределен для дальнейшего добавления графических элементов, (не ранее определенных в логическом дереве) для отображаемого элемента, например эффекты или графические элементы.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. Объект DrawingContext объект передается как аргумент, который предоставляет методы для рисования фигуры, текст, изображения или видео.A DrawingContext object is passed as an argument, which provides methods for drawing shapes, text, images or videos.

Применяется к