VisualCollection.Add(Visual) Metodo

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

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

ArgumentException

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

Nota

Per l'esempio completo, vedere Hit Test using DrawingVisuals Sample .For the complete sample, see Hit Test Using DrawingVisuals Sample.

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.