VisualCollection.Insert(Int32, 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.
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 -> unitPublic 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 .