VisualTreeHelper Classe

Définition

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Héritage

Object

VisualTreeHelper

Exemples

L’exemple suivant montre comment énumérer tous les descendants d’un objet visuel, qui est une technique utile si vous voulez sérialiser toutes les informations de rendu d’une hiérarchie d’objets visuels.

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

Remarques

Les nœuds de l’arborescence visuelle peuvent être soit Visual Visual3D des objets. Les méthodes spécifiques à un type d’objet visuel sont typées comme l’une Visual ou Visual3Dl’autre. Toutefois, certaines méthodes de la classe peuvent accepter une valeur qui représente l’un DependencyObject ou l’autre VisualTreeHelper type d’objet visuel.

WPF prend en charge l’accès par programmation à plusieurs structures d’arborescences différentes d’objets. Il s’agit principalement d’une arborescence visuelle et d’une arborescence logique. Dans certains cas, l’arborescence logique est une représentation plus utile des éléments dans une application WPF, mais l’arborescence logique est implémentée conceptuellement au-delà de la Visual classe. Contrairement à l’arborescence visuelle, l’arborescence logique peut représenter des objets de données non visuels, tels que ListItem. Pour plus d’informations sur l’arborescence logique, consultez Arborescences dans WPF. L’arborescence logique est également prise en charge par une classe de méthode utilitaire similaire. LogicalTreeHelper

Méthodes

S’applique à