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 w określonym indeksie.
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 zerach, w którym należy wstawić wartość.
- visual
- Visual
Element Visual do wstawienia 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ść VisualCollection obiektu zostanie zwiększona przed wstawieniem nowego Visual . 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 uwzględnić nowe Visualwartości indeksu , a ich wartości indeksu są aktualizowane.
Metoda Insert konfiguruje również relację nadrzędny-podrzędny między wizualizacją nadrzędną, która jest właścicielem VisualCollectionelementu , i podrzędnego 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 używania tych metod należy zdefiniować własną implementację magazynu i nie używać metody VisualCollection.
