VisualTreeHelper.GetChild(DependencyObject, Int32) Methode

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Gibt das untergeordnete visuelle Objekt vom angegebenen Auflistungsindex in einem angegebenen übergeordneten Element zurück.

public:
 static System::Windows::DependencyObject ^ GetChild(System::Windows::DependencyObject ^ reference, int childIndex);

public static System.Windows.DependencyObject GetChild (System.Windows.DependencyObject reference, int childIndex);

static member GetChild : System.Windows.DependencyObject * int -> System.Windows.DependencyObject

Public Shared Function GetChild (reference As DependencyObject, childIndex As Integer) As DependencyObject

Parameter

reference

DependencyObject

Das übergeordnete visuelle Element, auf das als DependencyObject verwiesen wird.

childIndex

Int32

Der Index, der das enthaltene untergeordnete visuelle Element als reference darstellt.

Gibt zurück

DependencyObject

Der Indexwert des untergeordneten visuellen Objekts.

Beispiele

Im folgenden Beispiel wird gezeigt, wie alle nachkommenden Elemente eines visuellen Objekts aufgelistet werden. Dies ist eine Technik, die Sie verwenden können, wenn Sie daran interessiert sind, alle Renderinginformationen einer visuellen Objekthierarchie zu serialisieren oder Eine Analyse oder ein alternatives Rendering durchzuführen.

// Enumerate all the descendants of the visual object.
static public void EnumVisual(Visual myVisual)
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(myVisual); i++)
    {
        // Retrieve child visual at specified index value.
        Visual childVisual = (Visual)VisualTreeHelper.GetChild(myVisual, i);

        // Do processing of the child visual object.

        // Enumerate children of the child visual object.
        EnumVisual(childVisual);
    }
}

' Enumerate all the descendants of the visual object.
Public Shared Sub EnumVisual(ByVal myVisual As Visual)
    For i As Integer = 0 To VisualTreeHelper.GetChildrenCount(myVisual) - 1
        ' Retrieve child visual at specified index value.
        Dim childVisual As Visual = CType(VisualTreeHelper.GetChild(myVisual, i), Visual)

        ' Do processing of the child visual object.

        ' Enumerate children of the child visual object.
        EnumVisual(childVisual)
    Next i
End Sub

Hinweise

Rufen Sie die GetChildrenCount -Methode auf, um die Gesamtzahl der untergeordneten Elemente eines übergeordneten Visuals zu bestimmen.

Der Wert von reference kann entweder ein Visual - oder Visual3D -Objekt darstellen, weshalb der allgemeine Basistyp DependencyObject hier als Parametertyp verwendet wird.