VisualTreeHelper Classe

Référence

Définition

Espace de noms:: System.Windows.Media

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des méthodes utilitaires qui exécutent des tâches courantes impliquant des nœuds dans une arborescence d’éléments visuels.

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

GetBitmapEffect(Visual)	Retourne la valeur BitmapEffect pour le Visual spécifié.
GetBitmapEffectInput(Visual)	Retourne la valeur BitmapEffectInput pour le Visual spécifié.
GetCacheMode(Visual)	Extrait la représentation mise en cache du Visual spécifié.
GetChild(DependencyObject, Int32)	Renvoie l'objet visuel enfant de l'index de collection spécifié dans un parent spécifié.
GetChildrenCount(DependencyObject)	Renvoie le nombre des enfants que contient l'objet visuel spécifié.
GetClip(Visual)	Renvoie la zone de découpage du Visual spécifié comme une valeur Geometry.
GetContentBounds(Visual)	Retourne le rectangle de cadre englobant mis en cache pour le Visual spécifié.
GetContentBounds(Visual3D)	Retourne le rectangle de cadre englobant mis en cache pour le Visual3D spécifié.
GetDescendantBounds(Visual)	Renvoie l'union de tous les cadres englobants de contenu pour tous les descendants du Visual, qui inclut le cadre englobant de contenu du Visual.
GetDescendantBounds(Visual3D)	Renvoie l'union de tous les cadres englobants de contenu pour tous les descendants du Visual3Dspécifié, qui inclut le cadre englobant de contenu du Visual3D
GetDpi(Visual)	Obtient les informations PPP avec lesquelles cet élément Visual est mesuré et rendu.
GetDrawing(Visual)	Renvoie le contenu de dessin du Visual spécifié.
GetEdgeMode(Visual)	Renvoie le mode de bord du Visual spécifié comme une valeur EdgeMode.
GetEffect(Visual)	Obtient l'effet bitmap pour le Visual spécifié.
GetOffset(Visual)	Renvoie l'offset du Visual.
GetOpacity(Visual)	Renvoie l'opacité du Visual.
GetOpacityMask(Visual)	Renvoie une valeur Brush qui représente le masque d'opacité du Visual.
GetParent(DependencyObject)	Retourne une valeur DependencyObject qui représente le parent de l’objet visuel.
GetTransform(Visual)	Renvoie une valeur Transform pour le Visual.
GetXSnappingGuidelines(Visual)	Retourne une collection d’indications de coordonnée X (verticale).
GetYSnappingGuidelines(Visual)	Retourne une collection d’indications de coordonnée Y (horizontale).
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Lance un test de positionnement sur le Visual spécifié, avec les méthodes HitTestFilterCallback et HitTestResultCallback définies par l’appelant.
HitTest(Visual, Point)	Retourne l’objet Visual supérieur d’un test de positionnement en spécifiant un Point.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Lance un test de positionnement sur le Visual3D spécifié, avec les méthodes HitTestFilterCallback et HitTestResultCallback définies par l’appelant.
SetRootDpi(Visual, DpiScale)	Met à jour les informations ppp d’un objet visuel. Ne peut être appelé que sur un élément visuel sans parent.

S’applique à