VisualTreeHelper Classe

Definição

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Herança

Object

VisualTreeHelper

Exemplos

O exemplo a seguir mostra como enumerar todos os descendentes de um objeto visual, que é uma técnica que você pode querer usar se estiver interessado em serializar todas as informações de renderização de uma hierarquia de objeto visual.

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

Os nós na árvore visual podem ser objetosVisual.Visual3D Métodos específicos de um tipo de objeto visual são tipados como ou VisualVisual3D. No entanto, alguns métodos na VisualTreeHelper classe podem aceitar um DependencyObject valor que representa qualquer um dos tipos de objeto visual.

O WPF suporta acesso programático a várias estruturas de árvore diferentes de objetos. Principalmente, isto é exposto como uma árvore visual e uma árvore lógica. Em alguns casos, a árvore lógica é uma representação mais útil dos elementos numa aplicação WPF, mas conceptualmente a árvore lógica é implementada a um nível além da classe Visual. Ao contrário da árvore visual, a árvore lógica pode representar objetos de dados não visuais, como ListItem. Para obter mais informações sobre a árvore lógica, consulte Árvores no WPF. A árvore lógica também é suportada por uma classe de método de utilidade semelhante, LogicalTreeHelper.