FrameworkElement.GetVisualChild(Int32) Metod

Definition

Namnområde:
System.Windows
Sammansättning:
PresentationFramework.dll

Åsidosätter GetVisualChild(Int32)och returnerar ett underordnat vid det angivna indexet från en samling underordnade element.

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

Parametrar

index
Int32

Det nollbaserade indexet för det begärda underordnade elementet i samlingen.

Returer

Visual

Det begärda underordnade elementet. Detta bör inte returnera null. Om det angivna indexet ligger utom intervallet genereras ett undantag.

Exempel

I följande exempel visas hur en anpassad utsmyckning använder de värden som deklareras av en VisualCollection som den underhåller för sina flera visuella underordnade objekt. Dessa värden rapporteras via åsidosättningar av VisualChildrenCount och 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

Kommentarer

I implementeringen FrameworkElement är det enda giltiga indexet noll. Innehållsmodellen för GetVisualChild stöder antingen noll eller ett underordnat element, inte en samling.

Anteckningar till arvingar

Den här implementeringen är endast giltig för element som inte upprätthåller någon mer beskrivande samling visuella underordnade element. Alla element som har en sådan samling måste åsidosätta den här metoden och mappa indexet till ett motsvarande index i den underordnade elementsamlingen som stöds av det elementet. Ett index i intervallet från noll till VisualChildrenCount (minus ett) ska returnera ett giltigt element. Alla andra index bör utlösa ett undantagsfel som ligger utom intervallet. Ett exempel på en elementtyp som stöder en underordnad samling och åsidosättningar för att returnera mer än en möjlig underordnad GetVisualChild(Int32) är Panel.

Standardimplementeringen i FrameworkElement förutsätter endast ett underordnat visuellt objekt. Alla värden som skickas för index andra än noll gör att ett undantag genereras. Flera vanliga element, till exempel dekoratörer, utsmyckningar eller element med specialiserad återgivning, åsidosätter FrameworkElement implementeringen (av implementeringen från mellanliggande basklasser). Vissa implementeringar framtvingar fortfarande ett visuellt underordnat objekt medan andra tillåter en samling.

Gäller för