VisualCollection.Insert(Int32, Visual) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Media

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

ArgumentOutOfRangeException

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