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.

 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)



特定の要素に対する描画命令。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.