Freigeben über


VisualCollection.Insert(Int32, Visual) Methode

Definition

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 -> unit
Public 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.

Gilt für