VisualCollection.Add(Visual) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Index dans la collection auquel visual
a été ajouté.
Exceptions
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.