Boîte de dialogue (référence d’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets Dialog Box à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets Boîte de dialogue dans différents frameworks d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence sur les API pour l’infrastructure d’interface utilisateur que vous utilisez.
Une boîte de dialogue est une fenêtre temporaire créée par une application pour récupérer les entrées utilisateur. Une application utilise des boîtes de dialogue pour inviter l’utilisateur à fournir des informations supplémentaires sur les commandes que l’utilisateur a choisies dans un menu. Une boîte de dialogue contient un ou plusieurs contrôles (fenêtres enfants) avec lesquels l’utilisateur entre du texte, choisit des options ou dirige l’action de la commande.
Le nom de la classe de fenêtre pour les boîtes de dialogue est « #32770 ».
IAccessible, méthodes
Une boîte de dialogue prend en charge les méthodes IAccessible suivantes :
| Méthode | Commentaires |
|---|---|
| accDoDefaultAction | Si la boîte de dialogue contient un bouton push par défaut, la méthode accDoDefaultAction appelle PostMessage avec le message de bouton BM_CLICK pour cliquer sur le bouton push par défaut. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propriétés IAccessible
Une boîte de dialogue prend en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChildCount | La propriété ChildCount est égale au nombre de contrôles de fenêtre enfant dans la boîte de dialogue. |
| get_accDefaultAction | Si la boîte de dialogue contient un bouton push par défaut, la propriété DefaultAction est « Appuyez ». |
| get_accFocus | |
| get_accKeyboardShortcut | En règle générale, les boîtes de dialogue n’ont pas de raccourcis clavier. Si le texte de la fenêtre de la boîte de dialogue contient un caractère esperluette (&), Microsoft Active Accessibility renvoie une chaîne non Null en tant que propriété KeyboardShortcut . |
| get_accName | La propriété Name est le texte de la fenêtre, ou légende, qui s’affiche dans la barre de titre de la boîte de dialogue. |
| get_accParent | La propriété Parent est une fenêtre ( ROLE_SYSTEM_WINDOW ) qui entoure la boîte de dialogue et a la même propriété Name et le même nom de classe de fenêtre que la boîte de dialogue. |
| get_accRole | La propriété Role est ROLE_SYSTEM_DIALOG ou ROLE_SYSTEM_PROPERTYPAGE. |
| get_accState | La propriété State est une combinaison d’une ou plusieurs des valeurs suivantes : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Notes
L’objet dialog ne prend pas en charge la méthode get_accChild . Pour obtenir un pointeur d’interface IAccessible vers un contrôle dans une boîte de dialogue, les clients doivent obtenir le handle de fenêtre du contrôle, puis appeler AccessibleObjectFromWindow.