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オブジェクトは、図形、テキスト、画像、またはビデオを描画するためのメソッドを提供する引数として渡されます。