VisualCollection.Add(Visual) Methode

Definitie

Naamruimte:
System.Windows.Media
Assembly:
PresentationCore.dll

Voegt een Visual aan het einde van de 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

Parameters

visual
Visual

De Visual toe te voegen aan de VisualCollection.

Retouren

Int32

De index in de verzameling waarop visual is toegevoegd.

Uitzonderingen

ArgumentException

Er ArgumentException wordt een gegenereerd als het Visual een hoofdelement is.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een VisualCollection leden maakt en eraan toevoegt.

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

Note

Zie Hit Test using DrawingVisuals Sample (Hit Test using DrawingVisuals Sample) voor het volledige voorbeeld.

Opmerkingen

Visual Een waarde toevoegen waarvan de waarde is null toegestaan en er wordt geen uitzondering gegenereerd.

Met Add de methode wordt ook de relatie tussen bovenliggende en onderliggende elementen ingesteld tussen de bovenliggende visual, de eigenaar van de VisualCollectionen het onderliggende visualelement.

Als u meer controle op laag niveau nodig hebt over de onderliggende opslag-implementatie van onderliggende visuele onderliggende objecten van een aangepaste klasse, kunt u overwegen de AddVisualChild en RemoveVisualChild methoden te gebruiken. Wanneer u deze methoden gebruikt, moet u uw eigen opslag-implementatie definiëren en niet gebruiken VisualCollection.

Van toepassing op