UIElement.OnRender(DrawingContext) Метод

Определение

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

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

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

Примеры

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

Комментарии

Этот метод не имеет реализации по умолчанию в классе 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.

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