Exporter (0) Imprimer
Développer tout
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

VisualTreeHelper, classe

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

System.Object
  System.Windows.Media.VisualTreeHelper

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

public static class VisualTreeHelper

Le type VisualTreeHelper expose les membres suivants.

  NomDescription
Méthode publiqueMembre statiqueFindElementsInHostCoordinates(Point, UIElement)
Méthode publiqueMembre statiqueFindElementsInHostCoordinates(Rect, UIElement)
Méthode publiqueMembre statiqueGetBitmapEffectRetourne la valeur BitmapEffect pour le Visual spécifié.
Méthode publiqueMembre statiqueGetBitmapEffectInputRetourne la valeur BitmapEffectInput pour le Visual spécifié.
Méthode publiqueMembre statiqueGetCacheModeExtrait la représentation mise en cache du Visual spécifié.
Méthode publiqueMembre statiqueGetChildRenvoie l'objet visuel enfant de l'index de collection spécifié dans un parent spécifié.
Méthode publiqueMembre statiqueGetChildrenCountRenvoie le nombre des enfants que contient l'objet visuel spécifié.
Méthode publiqueMembre statiqueGetClipRenvoie la zone de découpage du Visual spécifié comme une valeur Geometry.
Méthode publiqueMembre statiqueGetContentBounds(Visual)Retourne le rectangle de cadre englobant mis en cache pour le Visual spécifié.
Méthode publiqueMembre statiqueGetContentBounds(Visual3D)Retourne le rectangle de cadre englobant mis en cache pour le Visual3Dspécifié.
Méthode publiqueMembre statiqueGetDescendantBounds(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.
Méthode publiqueMembre statiqueGetDescendantBounds(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
Méthode publiqueMembre statiqueGetDrawingRenvoie le contenu de dessin du Visual spécifié.
Méthode publiqueMembre statiqueGetEdgeModeRenvoie le mode de bord du Visual spécifié comme une valeur EdgeMode.
Méthode publiqueMembre statiqueGetEffectObtient l'effet bitmap pour le Visual spécifié.
Méthode publiqueMembre statiqueGetOffsetRenvoie l'offset du Visual.
Méthode publiqueMembre statiqueGetOpacityRenvoie l'opacité du Visual.
Méthode publiqueMembre statiqueGetOpacityMaskRenvoie une valeur Brush qui représente le masque d'opacité du Visual.
Méthode publiqueMembre statiqueGetOpenPopups
Méthode publiqueMembre statiqueGetParentRenvoie une valeur DependencyObject qui représente le parent de l'objet visuel.
Méthode publiqueMembre statiqueGetTransformRenvoie une valeur Transform pour le Visual.
Méthode publiqueMembre statiqueGetXSnappingGuidelinesRenvoie une collection d'indications de la coordonnée X (verticale).
Méthode publiqueMembre statiqueGetYSnappingGuidelinesRenvoie une collection d'indications de la coordonnée Y (horizontale).
Méthode publiqueMembre statiqueHitTest(Visual, Point)Renvoie l'objet Visual du premier niveau d'un test de positionnement en spécifiant un Point.
Méthode publiqueMembre statiqueHitTest(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.
Méthode publiqueMembre statiqueHitTest(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

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.

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);
    }
}


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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.

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft