VisualCollection.Insert(Int32, Visual) Metodo

Definizione

Inserisce un elemento in VisualCollection in corrispondenza dell'indice specificato.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
Public Sub Insert (index As Integer, visual As Visual)

Parametri

index
Int32

Indice in base zero in corrispondenza del quale deve essere inserito il valore.The zero-based index at which the value should be inserted.

visual
Visual

Oggetto Visual da inserire in VisualCollection.The Visual to insert into the VisualCollection.

Eccezioni

index è minore di zero o maggiore di Count.index is less than zero or greater than Count.

Commenti

Se Count è già uguale Capacity, la capacità del VisualCollection viene aumentata prima che venga inserita la nuova Visual.If Count already equals Capacity, the capacity of the VisualCollection is increased before the new Visual is inserted. Se index è uguale a Count, visual viene aggiunto alla fine del VisualCollection.If index is equal to Count, visual is added to the end of VisualCollection. Gli oggetti visivi esistenti che sono uguali o maggiori di index vengono spostati in base alla nuova Visuale i relativi valori di indice vengono aggiornati.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.

Il metodo Insert imposta inoltre la relazione padre-figlio tra l'oggetto visivo padre, ovvero il proprietario del VisualCollectione il visualfiglio.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.

Se è necessario un maggiore controllo di basso livello sull'implementazione di archiviazione sottostante degli oggetti visivi figlio, provare a usare i metodi AddVisualChild e RemoveVisualChild.If you need greater low-level control over the underlying storage implementation of visual child objects, consider using the AddVisualChild and RemoveVisualChild methods. Quando si usano questi metodi, si definisce una propria implementazione di archiviazione e non si usa VisualCollection.When you use these methods, you define your own storage implementation, and do not use VisualCollection.

Si applica a