VisualCollection.Insert(Int32, Visual) VisualCollection.Insert(Int32, Visual) VisualCollection.Insert(Int32, Visual) Method

Définition

Insère un élément dans la classe VisualCollection au niveau de l'index spécifié.Inserts an element into the VisualCollection at the specified index.

public:
 void Insert(int index, System::Windows::Media::Visual ^ visual);
public void Insert (int index, System.Windows.Media.Visual visual);
member this.Insert : int * System.Windows.Media.Visual -> unit

Paramètres

index
Int32 Int32 Int32

Index de base zéro auquel la valeur doit être insérée.The zero-based index at which the value should be inserted.

visual
Visual Visual Visual

Le Visual à insérer dans le VisualCollection.The Visual to insert into the VisualCollection.

Exceptions

index est inférieur à 0 ou supérieur à Count.index is less than zero or greater than Count.

Remarques

Si Count est déjà Capacityégal à VisualCollection , la capacité de est augmentée avant l' Visual insertion du nouveau.If Count already equals Capacity, the capacity of the VisualCollection is increased before the new Visual is inserted. Si index est égal à Count, visual est ajouté à la fin de VisualCollection.If index is equal to Count, visual is added to the end of VisualCollection. Tous les objets visuels existants qui sont supérieurs index ou égaux à sont décalés pour prendre en compte le nouveau Visualet leurs valeurs d’index sont mises à jour.Any existing visual objects that are equal to or greater than index are shifted to accommodate the new Visual, and their index values are updated.

La Insert méthode définit également la relation parent-enfant entre le visuel parent, qui est le propriétaire VisualCollectionde, et l’enfant visual.The Insert method also sets up the parent-child relationship between the parent visual, which is the owner of the VisualCollection, and the child visual.

Si vous avez besoin d’un contrôle plus bas sur l’implémentation du stockage sous-jacent des objets enfants visuels AddVisualChild , RemoveVisualChild envisagez d’utiliser les méthodes et.If you need greater low-level control over the underlying storage implementation of visual child objects, consider using the AddVisualChild and RemoveVisualChild methods. Lorsque vous utilisez ces méthodes, vous définissez votre propre implémentation de stockage et n’utilisez VisualCollectionpas.When you use these methods, you define your own storage implementation, and do not use VisualCollection.

S’applique à