VisualTreeHelper.GetChild(DependencyObject, Int32) Metoda

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Vrátí podřízený objekt vizuálu ze zadaného indexu kolekce v rámci zadaného nadřazeného objektu.

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

Nadřazený vizuál, na který se DependencyObjectodkazuje jako .

childIndex

Int32

Index, který představuje podřízený vizuál obsažený v objektu reference.

Návraty

DependencyObject

Hodnota indexu podřízeného objektu vizuálu.

Příklady

Následující příklad ukazuje, jak vytvořit výčet všech potomků objektu vizuálu. Jedná se o techniku, kterou můžete použít, pokud máte zájem o serializaci všech informací o vykreslování v hierarchii vizuálních objektů nebo provádíte analýzu nebo alternativní vykreslování.

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

Poznámky

Voláním GetChildrenCount metody určíte celkový počet podřízených prvků nadřazeného vizuálu.

Hodnota reference může představovat objekt Visual nebo Visual3D , což je důvod, proč se zde jako typ parametru používá společný základní typ DependencyObject .