Udostępnij za pośrednictwem


VisualCollection.Insert(Int32, Visual) Metoda

Definicja

Wstawia element do VisualCollection określonego indeksu.

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)

Parametry

index
Int32

Indeks oparty na zera, w którym należy wstawić wartość.

visual
Visual

Element Visual , który ma być wstawiony do pliku VisualCollection.

Wyjątki

index wartość jest mniejsza niż zero lub większa niż Count.

Uwagi

Jeśli Count już równa Capacitysię , pojemność obiektu VisualCollection zostanie zwiększona przed wstawieniem nowego Visual elementu. Jeśli index wartość jest równa Count, visual zostanie dodana na końcu elementu VisualCollection. Wszystkie istniejące obiekty wizualne, które są równe lub większe niż index są przesunięte, aby pomieścić nowe Visualwartości indeksu, a ich wartości indeksu są aktualizowane.

Metoda Insert konfiguruje również relację nadrzędny-podrzędna między wizualizacją nadrzędną, która jest właścicielem VisualCollectionelementu , a elementem podrzędnym visual.

Jeśli potrzebujesz większej kontroli niskiego poziomu nad podstawową implementacją magazynu obiektów podrzędnych wizualizacji, rozważ użycie AddVisualChild metod i RemoveVisualChild . W przypadku korzystania z tych metod należy zdefiniować własną implementację magazynu i nie używać metody VisualCollection.

Dotyczy