Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

VisualTreeHelper classe

 

Date de publication : novembre 2016

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

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

System.Object
  System.Windows.Media.VisualTreeHelper

public static class VisualTreeHelper

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticGetBitmapEffect(Visual)

Retourne le BitmapEffect valeur du paramètre Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetBitmapEffectInput(Visual)

Retourne le BitmapEffectInput valeur du paramètre Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetCacheMode(Visual)

Récupère la représentation sous forme de mise en cache spécifié Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetChild(DependencyObject, Int32)

Retourne l’objet visuel enfant à partir de l’index de collection spécifié dans un parent spécifié.

System_CAPS_pubmethodSystem_CAPS_staticGetChildrenCount(DependencyObject)

Retourne le nombre d’enfants qui contient l’objet visuel spécifié.

System_CAPS_pubmethodSystem_CAPS_staticGetClip(Visual)

Retourner la zone de découpage de l’objet Visual comme un Geometry valeur.

System_CAPS_pubmethodSystem_CAPS_staticGetContentBounds(Visual)

Retourne le rectangle de cadre englobant mis en cache pour l’objet Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetContentBounds(Visual3D)

Retourne le rectangle de cadre englobant mis en cache pour l’objet Visual3D.

System_CAPS_pubmethodSystem_CAPS_staticGetDescendantBounds(Visual)

Retourne l'union de tous les contenus englobants pour tous les descendants de le Visual, qui inclut le cadre englobant de contenu du Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetDescendantBounds(Visual3D)

Retourne l’union de tous les contenus englobants pour tous les descendants de l’objet Visual3D, qui inclut le cadre englobant de contenu du Visual3D.

System_CAPS_pubmethodSystem_CAPS_staticGetDpi(Visual)

Obtient les informations PPP avec lesquelles cet élément Visual est mesuré et rendu.

System_CAPS_pubmethodSystem_CAPS_staticGetDrawing(Visual)

Retourne le contenu de dessin de l’objet Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetEdgeMode(Visual)

Retourne le mode de bord spécifié Visual comme un EdgeMode valeur.

System_CAPS_pubmethodSystem_CAPS_staticGetEffect(Visual)

Obtient l’effet bitmap spécifié Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOffset(Visual)

Retourne l’offset de la Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOpacity(Visual)

Renvoie l’opacité de la Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOpacityMask(Visual)

Retourne un Brush valeur qui représente le masque d’opacité de la Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetParent(DependencyObject)

Retourne une valeur DependencyObject qui représente le parent de l’objet visuel.

System_CAPS_pubmethodSystem_CAPS_staticGetTransform(Visual)

Retourne un Transform de valeur pour le Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetXSnappingGuidelines(Visual)

Retourne une collection d’indications de coordonnée X (verticale).

System_CAPS_pubmethodSystem_CAPS_staticGetYSnappingGuidelines(Visual)

Retourne une collection d’indications de coordonnée Y (horizontale).

System_CAPS_pubmethodSystem_CAPS_staticHitTest(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.

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual, Point)

Retourne l’objet Visual supérieur d’un test de positionnement en spécifiant un Point.

System_CAPS_pubmethodSystem_CAPS_staticHitTest(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.

System_CAPS_pubmethodSystem_CAPS_staticSetRootDpi(Visual, DpiScale)

Met à jour les informations ppp d’un objet visuel. Ne peut être appelé que sur un élément visuel sans parent.

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

WPF prend en charge l’accès par programme à plusieurs arborescences différentes d’objets. Principalement, cela est exposée comme une arborescence visuelle et en arborescence logique. Dans certains cas, l’arborescence logique est une représentation plus utile des éléments dans un WPF application, mais conceptuellement, l’arborescence logique est implémentée à un niveau 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 également est pris 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, qui est une technique utile à utiliser 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
Disponible depuis 3.0
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: