VisualTreeHelper.GetChild(DependencyObject, Int32) Methode

Definition

Namespace:
System.Windows.Media
Assembly:
PresentationCore.dll

Gibt das untergeordnete visuelle Objekt aus dem angegebenen Auflistungsindex innerhalb eines angegebenen übergeordneten Objekts 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 ein DependencyObjectElement verwiesen wird.

childIndex
Int32

Der Index, der das untergeordnete visuelle Element darstellt, in dem enthalten referenceist.

Gibt zurück

DependencyObject

Der Indexwert des untergeordneten visuellen Objekts.

Beispiele

Das folgende Beispiel zeigt, wie alle Nachfolger eines visuellen Objekts aufgezählt werden. Dies ist eine Technik, die Sie verwenden können, wenn Sie daran interessiert sind, alle Renderinginformationen einer visuellen Objekthierarchie zu serialisieren oder Analysen oder alternatives Rendering durchzuführen.

// Enumerate all the descendants of the visual object.
public static 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 Gesamtanzahl der untergeordneten Elemente eines übergeordneten visuellen Elements zu ermitteln.

Der Wert von reference can represent either a Visual or Visual3D object, which is why the common base type DependencyObject is used here as a parameter type.

Gilt für: