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