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 l’index VisualCollection 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
À Visual insérer dans le VisualCollection.
Exceptions
index est inférieur à zéro ou supérieur à Count.
Remarques
Si Count elle est Capacitydéjà égale, la capacité du nouveau 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écalé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 AddVisualChild les RemoveVisualChild méthodes. Lorsque vous utilisez ces méthodes, vous définissez votre propre implémentation de stockage et n’utilisez VisualCollectionpas .