Prise en charge d'UI Automation pour le type de contrôle ToolTip
.gif "Remarque") Remarque |
|---|
Cette documentation s'adresse aux développeurs .NET Framework qui veulent 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 (page éventuellement en anglais). |
Cette rubrique fournit des informations sur la prise en charge d'UI Automation pour le type de contrôle ToolTip. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'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 indépendantes qui contiennent du texte.
Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle ToolTip. Les spécifications UI Automation s'appliquent à tous les contrôles d'info-bulle, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32ou de Windows Forms.
Cette rubrique comprend les sections suivantes.
- Arborescence UI Automation requise
- Propriétés UI Automation requises
- Modèles de contrôle UI Automation requis
- Événements UI Automation requis
- Rubriques connexes
Arborescence UI Automation requise
Le tableau suivant décrit l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles d'info-bulle et décrit ce qui peut être inclus dans chaque vue. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.
Affichage de contrôle |
Affichage du contenu |
|---|---|
ToolTip
|
ToolTip |
Les contrôles d'info-bulle apparaissent dans l'affichage de contenu de l'arborescence UI Automation uniquement s'ils peuvent recevoir le focus clavier. Sinon, toutes les informations de l'info-bulle sont accessibles via la propriété HelpTextProperty de l'élément UI 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 qu'ils reçoivent régulièrement les informations contenues dans les info-bulles.
Propriétés UI Automation requises
Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles d'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 |
|---|---|---|
Consulter les remarques. |
La valeur de cette propriété doit être unique dans tous les contrôles d'une application. |
|
Consulter les remarques. |
Le rectangle le plus éloigné qui contient l'ensemble du contrôle. |
|
Consulter les remarques. |
Le point interactif doit faire partie de l'info-bulle qui va fermer le contrôle. Certaines info-bulles n'ont pas cette capacité et ne contiendront pas de point cliquable. |
|
Consulter les remarques. |
Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
|
Consulter les remarques. |
Le nom du contrôle d'info-bulle est le texte affiché dans cette info-bulle. |
|
Null |
Les contrôles d'info-bulle sont toujours étiquetés automatiquement par leur contenu. |
|
ToolTip |
Cette valeur est la même pour toutes les infrastructures d'interface utilisateur. |
|
"info-bulle" |
Chaîne localisée correspondant au type de contrôle ToolTip. |
|
Selon le cas |
Si le contrôle d'info-bulle peut recevoir le focus clavier, il doit figurer dans l'affichage du contenu de l'arborescence. S'il s'agit uniquement d'un texte, il est disponible en tant que HelpTextProperty à partir du contrôle qui l'a déclenché. |
|
True |
Le contrôle d'info-bulle doit toujours être un contrôle. |
Modèles de contrôle UI Automation requis
Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par les contrôles d'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 |
Prise en charge |
Remarques |
|---|---|---|
Selon le cas |
Les info-bulles qui peuvent être fermées par un clic sur un élément d'interface utilisateur doivent prendre en charge WindowPattern pour pouvoir se fermer automatiquement. |
|
Selon le cas |
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 lorsque le texte comporte du style enrichi et des attributs (par exemple, couleur, gras et italiques). |
Événements UI Automation requis
Les contrôles d'info-bulle doivent déclencher ToolTipOpenedEvent lorsqu'ils s'affichent à l'écran. L'événement inclura une référence à l'élément UI Automation de l'info‑bulle elle-même.
Le tableau suivant répertorie les événements UI Automation requis pour être pris en charge par tous les contrôles d'info-bulle. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.
Événement UI Automation |
Prise en charge |
Remarques |
|---|---|---|
Selon le cas |
Aucun |
|
Selon le cas |
Aucun |
|
Selon le cas |
Aucun |
|
Selon le cas |
Aucun |
|
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |
|
Événement de modification de propriété BoundingRectangleProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsOffscreenProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété IsEnabledProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété NameProperty. |
Obligatoire |
Aucun |
Événement de modification de propriété WindowVisualStateProperty. |
Selon le cas |
Aucun |
Obligatoire |
Aucun |
|
Obligatoire |
Aucun |