Condividi tramite


VisualCollection.Insert(Int32, Visual) Metodo

Definizione

Inserisce un elemento in VisualCollection in corrispondenza dell'indice specificato.

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.

visual
Visual

Oggetto Visual da inserire in VisualCollection.

Eccezioni

index è minore di zero o maggiore di Count.

Commenti

Se Count è già uguale a Capacity, la capacità di viene aumentata prima dell'inserimento VisualCollection del nuovo Visual oggetto. Se index è uguale a Count, visual viene aggiunto alla fine di VisualCollection. Tutti gli oggetti visivi esistenti uguali o maggiori di index vengono spostati per contenere il nuovo Visualoggetto e i relativi valori di indice vengono aggiornati.

Il Insert metodo configura anche la relazione padre-figlio tra l'oggetto visivo padre, che è il proprietario dell'oggetto VisualCollectione l'elemento figlio visual.

Se è necessario un maggiore controllo di basso livello sull'implementazione di archiviazione sottostante di oggetti figlio visivi, è consigliabile usare i AddVisualChild metodi e RemoveVisualChild . Quando si usano questi metodi, si definisce un'implementazione di archiviazione personalizzata e non si usa VisualCollection.

Si applica a