VisualTreeHelper Classe

Définition

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
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 d’éléments visuels peuvent être des Visual Visual3D objets ou. Les méthodes qui sont spécifiques à un type d’objet visuel sont tapées en tant que Visual ou Visual3D . Toutefois, certaines méthodes de la VisualTreeHelper classe peuvent accepter une DependencyObject valeur qui représente l’un ou l’autre type d’objet visuel.

WPF prend en charge l’accès par programme à plusieurs arborescences d’objets différentes. En premier lieu, il est exposé sous la forme d’une arborescence d’éléments visuels 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 conceptuellement, l’arborescence logique est implémentée à un niveau au-delà de la Visual classe. Contrairement à l’arborescence d’éléments visuels, l’arborescence logique peut représenter des objets de données qui ne sont pas des éléments 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 à