UIElement.OnRender(DrawingContext) メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

派生クラスでオーバーライドされると、レイアウト システムの指示で行われるレンダリング操作に参加します。 この要素に対するレンダリング指示は、このメソッドの呼び出し時に直接使用されるわけではなく、後からレイアウト処理や描画処理で非同期に使用されるときまで保存されます。

C#

protected virtual void OnRender (System.Windows.Media.DrawingContext drawingContext);

パラメーター

drawingContext

DrawingContext

特定の要素に対する描画命令。 このコンテキストはレイアウト システムに提供されます。

例

次のコード例は、パネル派生クラスの可能な実装を示しています。

C#

// 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);
}

注釈

このメソッドには、クラスに既定の UIElement 実装はありません。

注意 (継承者)

メソッドを OnRender(DrawingContext) オーバーライドして、(論理ツリーで以前に定義されていない) グラフィック要素を、効果や装飾などのレンダリングされた要素に追加できます。 DrawingContextオブジェクトは、図形、テキスト、画像、またはビデオを描画するためのメソッドを提供する引数として渡されます。

適用対象