UIElement.OnRender(DrawingContext) Метод

Определение

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

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 передается в качестве аргумента, который предоставляет методы для рисования фигур, текста, изображений или видео.

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