VisualCollection.Add(Visual) Méthode

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Ajoute un Visual à la fin du 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 à l’objet VisualCollection.

Retours

Int32

Index dans la collection à laquelle visual a été ajoutée.

Exceptions

ArgumentException

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

Exemples

L’exemple suivant montre comment créer et ajouter des VisualCollection membres à celui-ci.

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

Pour obtenir l’exemple complet, consultez Hit Test Using DrawingVisuals Sample.

Remarques

Ajout d’une Visual valeur 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 méthodes et RemoveVisualChild les AddVisualChild méthodes. Lorsque vous utilisez ces méthodes, vous devez définir votre propre implémentation de stockage et ne pas utiliser VisualCollection.