VisualCollection.Add(Visual) Metodo

Definizione

Accoda un oggetto Visual alla fine dell'oggetto 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

Parametri

visual
Visual

Oggetto Visual da aggiungere all'insieme VisualCollection.The Visual to append to the VisualCollection.

Restituisce

Indice nell'insieme in corrispondenza del quale è stato aggiunto il parametro visual.The index in the collection at which visual was added.

Eccezioni

Viene generato un oggetto ArgumentException se l'oggetto Visual è un elemento radice.An ArgumentException is thrown if the Visual is a root element.

Esempio

Nell'esempio seguente viene illustrato come creare un VisualCollection e aggiungervi membri.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

Nota

Per l'esempio completo, vedere l' esempio di hit test con DrawingVisuals.For the complete sample, see Hit Test Using DrawingVisuals Sample.

Commenti

L'aggiunta di un Visual il cui valore è null è consentita e non genera un'eccezione.Adding a Visual whose value is null is permitted and does not raise an exception.

Il metodo Add imposta inoltre la relazione padre-figlio tra l'oggetto visivo padre, ovvero il proprietario del VisualCollectione il visualfiglio.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 è necessario un maggiore controllo di basso livello sull'implementazione di archiviazione sottostante di oggetti visivi figlio di una classe personalizzata, provare a usare i metodi 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. Quando si usano questi metodi, è necessario definire una propria implementazione di archiviazione e non usare VisualCollection.When you use these methods, you must define your own storage implementation, and do not use VisualCollection.

Si applica a