VisualCollection.Insert(Int32, Visual) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic 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.