DrawingVisual.RenderOpen Methode

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Öffnet das DrawingVisual-Objekt für das Rendering. Der zurückgegebene DrawingContext-Wert kann zum Rendern in das DrawingVisual verwendet werden.

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

Gibt zurück

DrawingContext

Ein Wert vom Typ DrawingContext.

Beispiele

Im folgenden Beispiel wird ein DrawingVisual Objekt erstellt und zurückgegeben 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

Die Reihenfolge, in der Sie in den Zeichnungskontext zeichnen, ist wichtig – jede folgende Zeichnung wird über die anderen gezeichnet. Im folgenden Beispiel wird zuerst das Rechteck und dann der Text gezeichnet.

// 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()

Hinweise

Wenn Sie die Close -Methode von DrawingContextaufrufen, ersetzt der aktuelle Zeichnungsinhalt alle vorherigen Zeichnungsinhalte, die für definiert DrawingVisualwurden. Dies bedeutet, dass es keine Möglichkeit gibt, neue Zeichnungsinhalte an vorhandene Zeichnungsinhalte anzufügen.

Weitere Informationen

• Beispiel für Treffertests mit DarwingVisuals