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 ein Element in den VisualCollection angegebenen Index 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
The Visual to insert into the VisualCollection.
Ausnahmen
index ist kleiner als Null oder größer als Count.
Hinweise
Ist Count dies bereits der Wert, Capacitywird die Kapazität VisualCollection erhöht, bevor das 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 als sind, werden verschoben, um die neuen Visual, und ihre Indexwerte werden aktualisiert.
Die Insert Methode richtet auch die Beziehung zwischen dem übergeordneten visuellen Element ein, bei dem es sich um den Besitzer des VisualCollectionvisuellen Elements und das untergeordnete Element visualhandelt.
Wenn Sie eine bessere Kontrolle über die zugrunde liegende Speicherimplementierung von visuellen untergeordneten Objekten benötigen, sollten Sie die Verwendung und AddVisualChildRemoveVisualChild Methoden in Betracht ziehen. Wenn Sie diese Methoden verwenden, definieren Sie Ihre eigene Speicherimplementierung und verwenden VisualCollectionsie nicht.
