VisualCollection.Insert(Int32, Visual) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt am angegebenen Index ein Element in die VisualCollection ein.
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)Parameter
- index
- Int32
Der nullbasierte Index, an dem der Wert eingefügt werden soll.
- visual
- Visual
Die Visual, die in die VisualCollection eingefügt werden soll.
Ausnahmen
index ist kleiner als 0 (null) oder größer als Count.
Hinweise
Wenn Count bereits gleich Capacityist, wird die Kapazität der VisualCollection Neuen erhöht, bevor die neue Visual eingefügt wird. Ist index gleich Count, visual wird am Ende von VisualCollection. Alle vorhandenen visuellen Objekte, die gleich oder größer index sind, als verschoben werden, um die neuen Visual, und deren Indexwerte werden aktualisiert.
Die Insert Methode richtet auch die Beziehung zwischen der übergeordneten Visuellen, der Besitzer des VisualCollectionElements und dem untergeordneten Element visual, ein.
Wenn Sie eine höhere Kontrolle über die zugrunde liegende Speicherimplementierung visueller untergeordneter Objekte benötigen, sollten Sie die Verwendung der AddVisualChild Methoden und RemoveVisualChild Methoden berücksichtigen. Wenn Sie diese Methoden verwenden, definieren Sie ihre eigene Speicherimplementierung und verwenden VisualCollectionsie nicht.