VisualTreeHelper.GetChild(DependencyObject, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Zwraca obiekt wizualizacji podrzędnej z określonego indeksu kolekcji w określonym obiekcie nadrzędnym.

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

Parametry

reference

DependencyObject

Wizualizacja nadrzędna, do których odwołuje się element DependencyObject.

childIndex

Int32

Indeks reprezentujący wizualizację podrzędną zawartą przez referenceelement .

Zwraca

DependencyObject

Wartość indeksu obiektu wizualizacji podrzędnej.

Przykłady

W poniższym przykładzie pokazano, jak wyliczyć wszystkie elementy podrzędne obiektu wizualizacji. Jest to technika, której można użyć, jeśli interesuje Cię serializacja wszystkich informacji o renderowaniu hierarchii obiektów wizualizacji lub przeprowadzania analizy lub renderowania alternatywnego.

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

Uwagi

Wywołaj metodę , GetChildrenCount aby określić całkowitą liczbę elementów podrzędnych wizualizacji nadrzędnej.

Wartość reference może reprezentować obiekt Visual lub Visual3D , dlatego typ podstawowy DependencyObject jest używany tutaj jako typ parametru.