VisualCollection.Add(Visual) Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Ajoute le Visual à la fin de la 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

Paramètres

visual

Visual

Visual à ajouter à VisualCollection.

Retours

Int32

Index dans la collection auquel visual a été ajouté.

Exceptions

ArgumentException

Une ArgumentException est levée si le Visual est un élément racine.

Exemples

L’exemple suivant montre comment créer un et y ajouter des VisualCollection membres.

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

Notes

Pour obtenir l’exemple complet, consultez Test d’accès à l’aide de l’exemple DrawingVisuals.

Remarques

L’ajout d’un Visual dont la valeur est null autorisée et ne déclenche pas d’exception.

La Add méthode configure également la relation parent-enfant entre le visuel parent, qui est le propriétaire du VisualCollection, et l’enfant visual.

Si vous avez besoin d’un contrôle de bas niveau sur l’implémentation de stockage sous-jacente d’objets enfants visuels d’une classe personnalisée, envisagez d’utiliser les AddVisualChild méthodes et RemoveVisualChild . Lorsque vous utilisez ces méthodes, vous devez définir votre propre implémentation de stockage et ne pas utiliser VisualCollection.