VisualCollection.Add(Visual) Método

Definição

Espaço de Nomes:
System.Windows.Media
Assemblagem:
PresentationCore.dll

Acrescenta a Visual ao final do VisualCollection.

public:
 int Add(System::Windows::Media::Visual ^ visual);
public int Add(System.Windows.Media.Visual visual);
member this.Add : System.Windows.Media.Visual -> int
Public Function Add (visual As Visual) As Integer

Parâmetros

visual
Visual

O Visual para anexar ao VisualCollection.

Devoluções

Int32

O índice na coleção onde visual foi adicionado.

Exceções

ArgumentException

An ArgumentException é lançado se for Visual um elemento raiz.

Exemplos

O exemplo seguinte mostra como criar um VisualCollection e adicionar membros a ele.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyVisualHost : FrameworkElement
{
    // Create a collection of child visual objects.
    private VisualCollection _children;

    public MyVisualHost()
    {
        _children = new VisualCollection(this);
        _children.Add(CreateDrawingVisualRectangle());
        _children.Add(CreateDrawingVisualText());
        _children.Add(CreateDrawingVisualEllipses());

        // Add the event handler for MouseLeftButtonUp.
        this.MouseLeftButtonUp += new System.Windows.Input.MouseButtonEventHandler(MyVisualHost_MouseLeftButtonUp);
    }

' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyVisualHost
    Inherits FrameworkElement
    ' Create a collection of child visual objects.
    Private _children As VisualCollection

    Public Sub New()
        _children = New VisualCollection(Me)
        _children.Add(CreateDrawingVisualRectangle())
        _children.Add(CreateDrawingVisualText())
        _children.Add(CreateDrawingVisualEllipses())

        ' Add the event handler for MouseLeftButtonUp.
        AddHandler MouseLeftButtonUp, AddressOf MyVisualHost_MouseLeftButtonUp
    End Sub

Note

Para a amostra completa, veja Teste de Acerto Usando a Amostra DrawingVisuals.

Observações

Adicionar um Visual cujo valor é null permitido e não levanta exceção.

O Add método também estabelece a relação pai-filho entre o visual parental, que é o proprietário do VisualCollection, e o filho visual.

Se precisar de maior controlo de baixo nível sobre a implementação de armazenamento subjacente dos objetos visuais filhos de uma classe personalizada, considere usar os AddVisualChild métodos e.RemoveVisualChild Quando utiliza estes métodos, deve definir a sua própria implementação de armazenamento e não usar VisualCollection.

Aplica-se a