VisualCollection.Insert(Int32, Visual) Metoda

Reference

Definice

Obor názvů:: System.Windows.Media

Sestavení:: PresentationCore.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vloží prvek do zadaného indexu VisualCollection .

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

Index založený na nule, do kterého má být hodnota vložena.

visual: Visual

Vložení Visual do VisualCollectionsouboru .

Výjimky

ArgumentOutOfRangeException

index je menší než nula nebo větší než Count.

Poznámky

Pokud Count se již rovná Capacity, kapacita je VisualCollection zvýšena před vložením nového Visual . Je-li index rovno Count, visual je přidán na konec .VisualCollection Všechny existující vizuální objekty, které jsou stejné nebo větší, než index jsou posunuty tak, aby vyhovovaly novému Visualobjektu a jejich indexové hodnoty se aktualizují.

Metoda Insert také nastaví vztah nadřazeného-podřízeného mezi nadřazeným vizuálem, který je vlastníkem objektu VisualCollectiona podřízeného visualobjektu .

Pokud potřebujete větší kontrolu nad základní implementací úložiště podřízených objektů vizuálu, zvažte použití AddVisualChild a RemoveVisualChild metod. Při použití těchto metod definujete vlastní implementaci úložiště a nepoužíváte VisualCollection.

Platí pro

Sdílet prostřednictvím