Partager via

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

  • Article

Notes

Cette documentation s’adresse 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 dernières informations 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 l’IU Automation, un type de contrôle est un ensemble de conditions qu’un contrôle doit respecter pour pouvoir utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions spécifiques pour la structure d’arborescence, les valeurs de propriété et les modèles de contrôle de l’IU Automation.

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 de l’IU Automation, consultez Vue d’ensemble de l’arborescence de l’IU Automation.

Affichage de 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 de l’IU Automation, consultez Propriétés de l’IU Automation pour les clients.

Propriété UI Automation Valeur Notes
AutomationIdProperty Consultez les remarques. La valeur de cette propriété doit être unique dans tous les contrôles d’une application.
BoundingRectangleProperty Consultez les remarques. Rectangle externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les remarques. 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 remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty Consultez les remarques. 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 identique pour toutes les infrastructures d’interface utilisateur.
LocalizedControlTypeProperty « info-bulle » Chaîne localisée correspondant au type de contrôle ToolTip.
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 True 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 UI Automation Control Patterns Overview.

Modèle de contrôle Support Notes
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 Text est utile quand le texte possède un style complexe et des attributs (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 UI Automation Events Overview.

Événement UI Automation Support Notes
TextSelectionChangedEvent Dépend Aucun
TextChangedEvent Dépend Aucun
WindowClosedEvent Dépend Aucun
WindowOpenedEvent Dépend None
ToolTipOpenedEvent Obligatoire None
ToolTipClosedEvent Obligatoire None
Événement de modification de propriétéBoundingRectangleProperty Obligatoire None
Événement de modification de propriétéIsOffscreenProperty Obligatoire None
Événement de modification de propriétéIsEnabledProperty Obligatoire None
Événement de modification de propriétéNameProperty Obligatoire None
Événement de modification de propriétéWindowVisualStateProperty Dépend None
AutomationFocusChangedEvent Obligatoire None
StructureChangedEvent Obligatoire None

Voir aussi