VisualTreeHelper.GetChild(DependencyObject, Int32) VisualTreeHelper.GetChild(DependencyObject, Int32) VisualTreeHelper.GetChild(DependencyObject, Int32) VisualTreeHelper.GetChild(DependencyObject, Int32) Method

Definition

Gibt das untergeordnete visuelle Objekt vom angegebenen Auflistungsindex in einem angegebenen übergeordneten Element zurück.Returns the child visual object from the specified collection index within a specified parent.

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

Das übergeordnete visuelle Element, auf das als DependencyObject verwiesen wird.The parent visual, referenced as a DependencyObject.

childIndex
Int32 Int32 Int32 Int32

Der Index, der das enthaltene untergeordnete visuelle Element als reference darstellt.The index that represents the child visual that is contained by reference.

Gibt zurück

Der Indexwert des untergeordneten visuellen Objekts.The index value of the child visual object.

Beispiele

Im folgenden Beispiel wird gezeigt, wie alle Nachfolger eines visuellen Objekts aufgelistet werden.The following example shows how to enumerate all the descendants of a visual object. Dies ist eine Technik, die Sie möglicherweise verwenden, wenn Sie alle Renderinginformationen einer visuellen Objekthierarchie serialisieren möchten, oder wenn Sie eine Analyse oder ein alternatives Rendering durchführen möchten.This is a technique you might use if you are interested in serializing all the rendering information of a visual object hierarchy or are performing analysis or alternative rendering.

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

Ruft die GetChildrenCount -Methode auf, um die Gesamtzahl der untergeordneten Elemente eines übergeordneten visuellen Elements zu bestimmen.Call the GetChildrenCount method to determine the total number of child elements of a parent visual.

Der Wert von reference kann entweder ein Visual -oder Visual3D -Objekt darstellen, weshalb der allgemeine Basistyp DependencyObject hier als Parametertyp verwendet wird.The value of 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: