Partilhar via


VisualTreeHelper.GetChild(DependencyObject, Int32) Método

Definição

Retorna o objeto filho visual 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 que é contido pelo reference.

Retornos

DependencyObject

O valor de índice do objeto filho visual.

Exemplos

O exemplo a seguir mostra como enumerar todos os descendentes de um objeto visual. Essa é uma técnica que você pode usar se estiver interessado em serializar todas as informações de renderização de uma hierarquia de objetos visuais ou estiver executando análise ou renderização alternativa.

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

Comentários

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

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

Aplica-se a