Condividi tramite


VisualCollection.Add(Visual) Metodo

Definizione

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

Restituisce

Int32

Indice nell'insieme in corrispondenza del quale è stato aggiunto il parametro visual.

Eccezioni

Viene generato un oggetto ArgumentException se l'oggetto Visual è un elemento radice.

Esempio

Nell'esempio seguente viene illustrato come creare un VisualCollection oggetto e aggiungervi membri.

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

Commenti

Aggiunta di un oggetto Visual il cui valore è null consentito e non genera un'eccezione.

Il Add metodo configura anche la relazione padre-figlio tra l'oggetto visivo padre, che è il proprietario dell'oggetto VisualCollectione l'elemento figlio visual.

Se è necessario un maggiore controllo di basso livello sull'implementazione di archiviazione sottostante di oggetti figlio visivi di una classe personalizzata, è consigliabile usare i AddVisualChild metodi e RemoveVisualChild . Quando si usano questi metodi, è necessario definire la propria implementazione di archiviazione e non usare VisualCollection.

Si applica a