FrameworkElement.GetVisualChild(Int32) Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Überschreibt GetVisualChild(Int32) und gibt aus einer Auflistung untergeordneter Elemente ein untergeordnetes Element an der angegebenen Indexposition zurück.

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

Parameter

index

Int32

Der nullbasierte Index des angeforderten untergeordneten Elements in der Auflistung.

Gibt zurück

Visual

Das angeforderte untergeordnete Element. Es sollte nicht null zurückgeben; wenn der angegebene Index außerhalb des Bereichs liegt, wird eine Ausnahme ausgelöst.

Beispiele

Das folgende Beispiel zeigt, wie ein benutzerdefinierter Adorner die von einem VisualCollection deklarierten Werte verwendet, die er für seine mehreren visuellen untergeordneten Elemente verwaltet. Diese Werte werden über Außerkraftsetzungen von VisualChildrenCount und GetVisualChildgemeldet.

// 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

Hinweise

In der FrameworkElement Implementierung ist der einzige gültige Index null. Das Inhaltsmodell für GetVisualChild unterstützt entweder null oder ein untergeordnetes Element, keine Auflistung.

Hinweise für Vererber

Diese Implementierung ist nur für Elemente gültig, die keine beschreibendere Auflistung visueller untergeordneter Elemente verwalten. Jedes Element, das über eine solche Auflistung verfügt, muss diese Methode überschreiben und den Index einem entsprechenden Index in der untergeordneten Elementauflistung zuordnen, die von diesem Element unterstützt wird. Ein Index im Bereich von null bis VisualChildrenCount (minus 1) sollte ein gültiges Element zurückgeben. Jeder andere Index sollte eine Ausnahme außerhalb des Bereichs auslösen. Ein Beispiel für einen Elementtyp, der eine untergeordnete Auflistung unterstützt und außer Kraft setzt, GetVisualChild(Int32) um mehr als ein mögliches untergeordnetes Element zurückzugeben, ist Panel.

Die Standardimplementierung in FrameworkElement setzt nur ein untergeordnetes visuelles Element voraus. Jeder wert, der für index einen anderen als null übergeben wird, bewirkt, dass eine Ausnahme ausgelöst wird. Mehrere gängige Elemente, z. B. Decorators, Adorner oder Elemente mit spezialisiertem Rendering, überschreiben die FrameworkElement Implementierung (der Implementierung aus zwischengeschalteten Basisklassen). Einige Implementierungen erzwingen weiterhin ein untergeordnetes visuelles Element, während andere eine Sammlung zulassen.