DrawingVisual.RenderOpen メソッド

定義

名前空間:

System.Windows.Media

アセンブリ:

PresentationCore.dll

レンダリング対象の DrawingVisual オブジェクトを開きます。 返された DrawingContext 値は DrawingVisual にレンダリングするために使用できます。

public:
 System::Windows::Media::DrawingContext ^ RenderOpen();

public System.Windows.Media.DrawingContext RenderOpen ();

member this.RenderOpen : unit -> System.Windows.Media.DrawingContext

Public Function RenderOpen () As DrawingContext

戻り値

DrawingContext

DrawingContext 型の値。

例

次の例では、 DrawingVisual オブジェクトが作成され、そのオブジェクトが DrawingContext 返されます。

// Create a DrawingVisual that contains a rectangle.
private DrawingVisual CreateDrawingVisualRectangle()
{
    DrawingVisual drawingVisual = new DrawingVisual();

    // Retrieve the DrawingContext in order to create new drawing content.
    DrawingContext drawingContext = drawingVisual.RenderOpen();

    // Create a rectangle and draw it in the DrawingContext.
    Rect rect = new Rect(new System.Windows.Point(160, 100), new System.Windows.Size(320, 80));
    drawingContext.DrawRectangle(System.Windows.Media.Brushes.LightBlue, (System.Windows.Media.Pen)null, rect);

    // Persist the drawing content.
    drawingContext.Close();

    return drawingVisual;
}

' Create a DrawingVisual that contains a rectangle.
Private Function CreateDrawingVisualRectangle() As DrawingVisual
    Dim drawingVisual As New DrawingVisual()

    ' Retrieve the DrawingContext in order to create new drawing content.
    Dim drawingContext As DrawingContext = drawingVisual.RenderOpen()

    ' Create a rectangle and draw it in the DrawingContext.
    Dim rect As New Rect(New Point(160, 100), New Size(320, 80))
    drawingContext.DrawRectangle(Brushes.LightBlue, CType(Nothing, Pen), rect)

    ' Persist the drawing content.
    drawingContext.Close()

    Return drawingVisual
End Function

描画コンテキストに描画する順序は重要です。後続の各描画は、他の描画の上に描画されます。 次の例では、四角形が最初に描画され、次にテキストが描画されます。

// Retrieve the DrawingContext in order to draw into the visual object.
DrawingContext drawingContext = drawingVisual.RenderOpen();

// Draw a rectangle into the DrawingContext.
Rect rect = new Rect(new Point(160, 100), new Size(320, 80));
drawingContext.DrawRectangle(Brushes.LightBlue, (Pen)null, rect);

// Draw a formatted text string into the DrawingContext.
drawingContext.DrawText(
   new FormattedText("Hello, world",
      CultureInfo.GetCultureInfo("en-us"),
      FlowDirection.LeftToRight,
      new Typeface("Verdana"),
      36, Brushes.Black),
      new Point(200, 116));

// Persist the drawing content.
drawingContext.Close();

' Retrieve the DrawingContext in order to draw into the visual object.
Dim drawingContext As DrawingContext = drawingVisual.RenderOpen()

' Draw a rectangle into the DrawingContext.
Dim rect As New Rect(New Point(160, 100), New Size(320, 80))
drawingContext.DrawRectangle(Brushes.LightBlue, CType(Nothing, Pen), rect)

' Draw a formatted text string into the DrawingContext.
drawingContext.DrawText(New FormattedText("Hello, world", CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight, New Typeface("Verdana"), 36, Brushes.Black), New Point(200, 116))

' Persist the drawing content.
drawingContext.Close()

注釈

のメソッドDrawingContextをClose呼び出すと、現在の図面コンテンツは、 に対してDrawingVisual定義されている以前の描画コンテンツを置き換えます。 つまり、既存の図面コンテンツに新しい図面コンテンツを追加する方法はありません。

こちらもご覧ください

• DrawingVisuals を使用したヒット テストのサンプル