VisualCollection.Insert(Int32, Visual) Metoda
Definicja
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 -> unitPublic 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.