VisualTreeHelper.GetChild(DependencyObject, Int32) Método

Definição

Espaço de Nomes:
System.Windows.Media
Assemblagem:
PresentationCore.dll

Devolve o objeto visual filho do índice de coleção especificado dentro de um pai especificado.

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

Parâmetros

reference
DependencyObject

O visual pai, referenciado como um DependencyObject.

childIndex
Int32

O índice que representa o visual filho contido por reference.

Devoluções

DependencyObject

O valor do índice do objeto visual filho.

Exemplos

O exemplo seguinte mostra como enumerar todos os descendentes de um objeto visual. Esta é uma técnica que pode usar se estiver interessado em serializar toda a informação de renderização de uma hierarquia visual de objetos ou se estiver a realizar análises ou renderização alternativa.

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

Observações

Chame o GetChildrenCount método para determinar o número total de elementos filhos de um visual parental.

O valor de reference pode representar um Visual ou Visual3D um objeto, razão pela qual o tipo DependencyObject base comum é usado aqui como tipo de parâmetro.

Aplica-se a