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 talvez você queira usar caso esteja interessado em serializar a informação de renderização de uma hierarquia de objetos visuais.

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

Comentários

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

O WPF dá suporte ao acesso programático a várias estruturas de árvore diferentes de objetos. Principalmente, isso é exposto como uma árvore visual e uma árvore lógica. Em alguns casos, a árvore lógica é uma representação mais útil dos elementos em um aplicativo WPF, mas conceitualmente a árvore lógica é implementada em um nível além da Visual classe . 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 é compatível com uma classe de método utilitário semelhante, LogicalTreeHelper.

Métodos

Aplica-se a