DrawingVisual.RenderOpen Método

Definição

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Abre o objeto DrawingVisual para renderização. O valor DrawingContext retornado pode ser usado para renderizar no 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

Retornos

DrawingContext

Um valor do tipo DrawingContext.

Exemplos

No exemplo a seguir, um DrawingVisual objeto é criado e o DrawingContext retornado.

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

A ordem na qual você desenha no contexto de desenho é importante – cada desenho bem-sucedido é desenhado sobre os outros. No exemplo a seguir, o retângulo é desenhado primeiro e, em seguida, o texto.

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

Comentários

Quando você chama o Close método do DrawingContext, o conteúdo do desenho atual substitui qualquer conteúdo de desenho anterior definido para o DrawingVisual. Isso significa que não há como acrescentar novo conteúdo de desenho ao conteúdo de desenho existente.

Confira também

• Exemplo de teste de clique usando DrawingVisuals