VisualCollection.Add(Visual) Método

Definição

Acrescenta um Visual ao final da VisualCollection.Appends a Visual to the end of the 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 a acrescentar ao VisualCollection.The Visual to append to the VisualCollection.

Retornos

O índice na coleção em que o visual foi adicionado.The index in the collection at which visual was added.

Exceções

Uma ArgumentException será gerada se o Visual for um elemento raiz.An ArgumentException is thrown if the Visual is a root element.

Exemplos

O exemplo a seguir mostra como criar um VisualCollection e adicionar membros a ele.The following example shows how to create a VisualCollection and add members to it.

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

Observação

Para obter o exemplo completo, consulte teste de clique usando o exemplo de DrawingVisuals.For the complete sample, see Hit Test Using DrawingVisuals Sample.

Comentários

Adicionar um Visual cujo valor é null é permitido e não gera uma exceção.Adding a Visual whose value is null is permitted and does not raise an exception.

O método Add também configura a relação pai-filho entre o visual pai, que é o proprietário do VisualCollectione o visualfilho.The Add method also sets up the parent-child relationship between the parent visual, which is the owner of the VisualCollection, and the child visual.

Se você precisar de mais controle de nível baixo sobre a implementação de armazenamento subjacente de objetos filho visual de uma classe personalizada, considere usar os métodos AddVisualChild e RemoveVisualChild.If you need greater low-level control over the underlying storage implementation of visual child objects of a custom class, consider using the AddVisualChild and RemoveVisualChild methods. Ao usar esses métodos, você deve definir sua própria implementação de armazenamento e não usar VisualCollection.When you use these methods, you must define your own storage implementation, and do not use VisualCollection.

Aplica-se a