FrameworkElement.GetVisualChild(Int32) Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

GetVisualChild(Int32)Přepíše a vrátí podřízenou hodnotu v zadaném indexu z kolekce podřízených prvků.

protected:
 override System::Windows::Media::Visual ^ GetVisualChild(int index);

protected override System.Windows.Media.Visual GetVisualChild(int index);

override this.GetVisualChild : int -> System.Windows.Media.Visual

Protected Overrides Function GetVisualChild (index As Integer) As Visual

Parametry

index

Int32

Index založený na nule požadovaného podřízeného prvku v kolekci.

Návraty

Visual

Požadovaný podřízený prvek. Nemělo by se to vracet null. Pokud je zadaný index mimo rozsah, vyvolá se výjimka.

Příklady

Následující příklad ukazuje, jak vlastní adorner používá hodnoty deklarované VisualCollection pro své více podřízených vizuálů. Tyto hodnoty jsou hlášeny prostřednictvím přepsání VisualChildrenCount a GetVisualChild.

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

' To store and manage the adorner's visual children.
Private visualChildren As VisualCollection

// Override the VisualChildrenCount and GetVisualChild properties to interface with 
// the adorner's visual collection.
protected override int VisualChildrenCount { get { return visualChildren.Count; } }
protected override Visual GetVisualChild(int index) { return visualChildren[index]; }

' Override the VisualChildrenCount and GetVisualChild properties to interface with 
' the adorner's visual collection.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
    Get
        Return visualChildren.Count
    End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    Return visualChildren(index)
End Function

Poznámky

V implementaci FrameworkElement je jediným platným indexem nula. Model obsahu podporuje GetVisualChild buď nula, nebo jeden podřízený prvek, nikoli kolekci.

Poznámky pro dědice

Tato implementace je platná pouze pro prvky, které neudržují žádnou popisnější kolekci podřízených prvků vizuálu. Každý prvek, který má takovou kolekci, musí přepsat tuto metodu a mapovat index na ekvivalentní index v podřízené kolekci elementů, která je podporována tímto elementem. Index v rozsahu od nuly do VisualChildrenCount (minus 1) by měl vrátit platný prvek; jakýkoli jiný index by měl vyvolat výjimku mimo rozsah. Příkladem typu elementu, který podporuje podřízenou kolekci a přepsání GetVisualChild(Int32) pro vrácení více než jednoho možného podřízeného objektu je Panel.

Výchozí implementace FrameworkElement předpokládá pouze jeden podřízený vizuál. Jakákoli hodnota předaná pro index jinou než nulu způsobí vyvolání výjimky. Několik společných prvků, jako jsou dekorátory, doplňky nebo prvky se specializovaným vykreslováním, přepíší FrameworkElement implementaci (implementace z mezilehlých základních tříd). Některé implementace stále vynucují jedno podřízené vizuály, zatímco jiné umožňují kolekci.