Partager via


VisualCollection.Insert(Int32, Visual) Méthode

Définition

Insère un élément dans la classe VisualCollection au niveau de l'index spécifié.

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
Public Sub Insert (index As Integer, visual As Visual)

Paramètres

index
Int32

Index de base zéro auquel la valeur doit être insérée.

visual
Visual

Le Visual à insérer dans le VisualCollection.

Exceptions

index est inférieur à 0 ou supérieur à Count.

Remarques

Si Count elle est déjà égale Capacity, la capacité de l’élément VisualCollection est augmentée avant l’insertion du nouveau Visual . S’il index est égal à Count, visual est ajouté à la fin de VisualCollection. Tous les objets visuels existants qui sont égaux ou supérieurs index à ceux qui sont déplacés pour prendre en charge le nouveau Visual, et leurs valeurs d’index sont mises à jour.

La Insert 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 meilleur contrôle de bas niveau sur l’implémentation de stockage sous-jacente des objets enfants visuels, envisagez d’utiliser les méthodes et RemoveVisualChild les AddVisualChild méthodes. Lorsque vous utilisez ces méthodes, vous définissez votre propre implémentation de stockage et n’utilisez VisualCollectionpas .

S’applique à