VisualTreeHelper Clase

Definición

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Herencia

Object

VisualTreeHelper

Ejemplos

En el ejemplo siguiente se muestra cómo enumerar todos los descendientes de un objeto visual, que es una técnica que puede usar si le interesa serializar toda la información de representación de una jerarquía de objetos visuales.

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

Comentarios

Los nodos del árbol visual pueden ser Visual objetos o Visual3D . Los métodos específicos de un tipo de objeto visual se escriben como Visual o Visual3D. Sin embargo, algunos métodos de la VisualTreeHelper clase pueden aceptar un DependencyObject valor que representa cualquier tipo de objeto visual.

WPF admite el acceso mediante programación a varias estructuras de árbol diferentes de objetos. Principalmente, esto se expone como un árbol visual y un árbol lógico. En algunos casos, el árbol lógico es una representación más útil de los elementos de una aplicación WPF, pero conceptualmente el árbol lógico se implementa en un nivel más allá de la Visual clase. A diferencia del árbol visual, el árbol lógico puede representar objetos de datos no visuales, como ListItem. Para obtener más información sobre el árbol lógico, vea Árboles en WPF. El árbol lógico también es compatible con una clase de método de utilidad similar, LogicalTreeHelper.