VisualCollection.Add(Visual) Methode

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Fügt ein Visual an das Ende der VisualCollection an.

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

Parameter

visual

Visual

Das an Visual anzufügende VisualCollection.

Gibt zurück

Int32

Der Index in der Auflistung, an dem das visual-Objekt hinzugefügt wurde.

Ausnahmen

ArgumentException

Wenn das ArgumentException ein Stammelement ist, wird eine Visual ausgelöst.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie einen VisualCollection erstellen und ihr Member hinzufügen.

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

Hinweis

Das vollständige Beispiel finden Sie unter Treffertest mithilfe von DrawingVisuals Sample.

Hinweise

Das Hinzufügen eines Visual , dessen Wert zulässig ist null und keine Ausnahme auslöst.

Die Add -Methode richtet auch die Beziehung zwischen dem übergeordneten Visual, dem Besitzer von VisualCollection, und dem untergeordneten visualVisual ein.

Wenn Sie eine bessere Kontrolle über die zugrunde liegende Speicherimplementierung von visuellen untergeordneten Objekten einer benutzerdefinierten Klasse benötigen, sollten Sie die AddVisualChild Methoden und RemoveVisualChild verwenden. Wenn Sie diese Methoden verwenden, müssen Sie Ihre eigene Speicherimplementierung definieren und nicht verwenden VisualCollection.