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

適用対象