UIElement.OnRender(DrawingContext) Метод

Определение

Пространство имен:
System.Windows
Сборка:
PresentationCore.dll

При переопределении в производном классе участвует в операциях отрисовки, направленных системой макета. Инструкции по отрисовке этого элемента не используются непосредственно при вызове этого метода и вместо этого сохраняются для последующего асинхронного использования макетом и рисованием.

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)

Параметры

drawingContext
DrawingContext

Инструкции по рисованию для определенного элемента. Этот контекст предоставляется системе макета.

Примеры

В следующем примере кода показана возможная реализация для производного класса панели.

// 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 классе.

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

Метод OnRender(DrawingContext) можно переопределить для добавления дополнительных графических элементов (не определенных ранее в логическом дереве) в отрисованный элемент, например эффекты или украшения. DrawingContext Объект передается в качестве аргумента, который предоставляет методы для рисования фигур, текста, изображений или видео.

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