Partager via

Prise en charge d'UI Automation pour le type de contrôle ToolTip

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation.

Cette rubrique fournit des informations sur la prise en charge de l’IU Automation pour le type de contrôle Info-bulle. Dans UI Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour utiliser la ControlTypeProperty propriété. Les conditions incluent des instructions spécifiques pour la structure d’arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.

Les contrôles d’info-bulle sont des fenêtres contextuelles qui contiennent du texte.

Les sections suivantes définissent l’arborescence, les propriétés, les modèles de contrôle et les événements de l’IU Automation nécessaires pour le type de contrôle Info-bulle. Les exigences de l’IU Automation s’appliquent à tous les contrôles Info-bulle, que ce soit Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant représente l’affichage de contrôle et l’affichage du contenu de l’arborescence de l’IU Automation relative aux contrôles infi-bulle. En outre, il décrit ce que peut contenir chaque affichage. Pour plus d’informations sur l’arborescence UI Automation, consultez vue d’ensemble de l’arborescence UI Automation.

Vue contrôle Affichage de contenu
Info-bulle

- Texte (0 ou plus)
- Image (0 ou plus)		 Info-bulle

Les contrôles d’info-bulle apparaissent uniquement dans l’affichage de contenu de l’arborescence de l’IU Automation s’ils peuvent recevoir le focus clavier. Sinon, toutes les informations de l’info-bulle sont disponibles à partir de la propriété HelpTextProperty sur l’élément de l’IU Automation auquel l’info-bulle fait référence.

Les info-bulles doivent apparaître sous le contrôle auquel leurs informations font référence. Les clients doivent écouter ToolTipOpenedEvent pour s’assurer d’obtenir constamment les informations contenues dans les info-bulles.

Propriétés UI Automation obligatoires

Le tableau suivant répertorie les propriétés de l’IU Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles Info-bulle. Pour plus d’informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation Valeur Remarques
AutomationIdProperty Consultez les notes. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les notes. Rectangle le plus externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les notes. La zone interactive doit être la partie de l’info-bulle qui va masquer le contrôle. Certaines info-bulles n’ont pas cette possibilité et n’ont pas de zone interactive.
IsKeyboardFocusableProperty Consultez les notes. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Consultez les notes. Le nom du contrôle d’info-bulle est le texte affiché dans l’info-bulle.
LabeledByProperty Null Les contrôles d’info-bulle sont toujours étiquetés automatiquement par leur contenu.
ControlTypeProperty Info-bulle Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « info-bulle » Chaîne localisée correspondant au type de contrôle Info-bulle.
IsContentElementProperty Dépend Si le contrôle d’info-bulle peut recevoir le focus clavier, il doit figurer dans l’affichage de contenu de l’arborescence. S’il s’agit uniquement de texte, il est disponible en tant que HelpTextProperty à partir du contrôle qui l’a déclenché.
IsControlElementProperty Vrai Le contrôle d’info-bulle doit toujours être un contrôle.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle de l’IU Automation qui doivent être pris en charge par les contrôles Info-bulle. Pour plus d’informations sur les modèles de contrôle, consultez Vue d’ensemble des modèles de contrôle UI Automation.

Modèle de contrôle Soutien Remarques
IWindowProvider Dépend Les info-bulles qui peuvent être fermées en cliquant sur un élément d’interface utilisateur doivent prendre en charge WindowPattern pour pouvoir se fermer automatiquement.
ITextProvider Dépend Pour une meilleure accessibilité, un contrôle d’info-bulle peut prendre en charge le modèle de contrôle Text, bien que ce ne soit pas obligatoire. Le modèle de contrôle Texte est utile lorsque le texte a un style et des attributs enrichis (par exemple, couleur, gras et italique).

Événements UI Automation obligatoires

Les contrôles d’info-bulle doivent déclencher ToolTipOpenedEvent quand ils s’affichent à l’écran. L’événement inclut une référence à l’élément de l’IU Automation de l’info-bulle elle-même.

Le tableau suivant répertorie les événements de l’IU Automation qui doivent être pris en charge par tous les contrôles Info-bulle. Pour plus d’informations sur les événements, consultez Vue d’ensemble des événements UI Automation.

Événement UI Automation Soutien Remarques
TextSelectionChangedEvent Dépend Aucun
TextChangedEvent Dépend Aucun
WindowClosedEvent Dépend Aucun
WindowOpenedEvent Dépend Aucun
ToolTipOpenedEvent Obligatoire Aucun
ToolTipClosedEvent Obligatoire Aucun
Événement de modification de la propriété BoundingRectangleProperty. Obligatoire Aucun
Événement de modification de la propriété IsOffscreenProperty. Obligatoire Aucun
Événement de modification de la propriété IsEnabledProperty. Obligatoire Aucun
Événement de modification de la propriété NameProperty. Obligatoire Aucun
Événement de modification de la propriété WindowVisualStateProperty. Dépend Aucun
AutomationFocusChangedEvent Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun

Voir aussi