Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

VisualTreeHelper, classe

.NET Framework 4.5

Autres versions

Fournit des méthodes utilitaires qui exécutent des tâches courantes impliquant des nœuds dans une arborescence visuelle.

Hiérarchie d'héritage

System.Object
System.Windows.Media.VisualTreeHelper

Espace de noms : System.Windows.Media
Assembly : PresentationCore (dans PresentationCore.dll)

Syntaxe

C++

public static class VisualTreeHelper

Le type VisualTreeHelper expose les membres suivants.

Méthodes

	Nom	Description
	GetBitmapEffect	Retourne la valeur BitmapEffect pour le Visual spécifié.
	GetBitmapEffectInput	Retourne la valeur BitmapEffectInput pour le Visual spécifié.
	GetCacheMode	Extrait la représentation mise en cache du Visual spécifié.
	GetChild	Renvoie l'objet visuel enfant de l'index de collection spécifié dans un parent spécifié.
	GetChildrenCount	Renvoie le nombre des enfants que contient l'objet visuel spécifié.
	GetClip	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 Visual3Dspé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
	GetDrawing	Renvoie le contenu de dessin du Visual spécifié.
	GetEdgeMode	Renvoie le mode de bord du Visual spécifié comme une valeur EdgeMode.
	GetEffect	Obtient l'effet bitmap pour le Visual spécifié.
	GetOffset	Renvoie l'offset du Visual.
	GetOpacity	Renvoie l'opacité du Visual.
	GetOpacityMask	Renvoie une valeur Brush qui représente le masque d'opacité du Visual.
	GetParent	Renvoie une valeur DependencyObject qui représente le parent de l'objet visuel.
	GetTransform	Renvoie une valeur Transform pour le Visual.
	GetXSnappingGuidelines	Renvoie une collection d'indications de la coordonnée X (verticale).
	GetYSnappingGuidelines	Renvoie une collection d'indications de la coordonnée Y (horizontale).
	HitTest(Visual, Point)	Renvoie l'objet Visual du premier niveau d'un test de positionnement en spécifiant un Point.
	HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Initialise un test de positionnement sur le Visual spécifié, avec les méthodesHitTestFilterCallback et HitTestResultCallback définies par l'appelant.
	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.

Début

Notes

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

WPF prend en charge l'accès par programme à plusieurs arborescences différentes d'objets. En général, l'ensemble s'expose en arborescence visuelle et en 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 classe Visual. Contrairement à l'arborescence visuelle, l'arborescence logique peut représenter des objets de donnée 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 semblable, LogicalTreeHelper.

Exemples

L'exemple suivant montre comment énumérer tous les descendants d'un objet visuel, 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);
    }
}

Informations de version

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

System.Windows.Media, espace de noms

Autres ressources

Comment : rechercher des éléments générés par DataTemplate

Arborescences dans WPF

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER