Boîte de dialogue (référence de l’élément d’interface utilisateur MSAA)
Note
Cette rubrique décrit boîte de dialogue objets à des fins de référence d’élément d’interface utilisateur MSAA. La création d'boîte de dialogue objets dans différentes infrastructures d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence de l’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 l’entrée utilisateur. Une application utilise des boîtes de dialogue pour inviter l’utilisateur à obtenir des informations supplémentaires sur les commandes choisies par l’utilisateur 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 ».
Méthodes IAccessible
Une boîte de dialogue prend en charge les méthodesIAccessible 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 du 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 « Press ». |
| get_accFocus | |
| get_accKeyboardShortcut | En règle générale, les boîtes de dialogue ne disposent pas de raccourcis clavier. Si le texte de la fenêtre de la boîte de dialogue contient un caractère ampersand (&), Microsoft Active Accessibility renvoie une chaîne non Null comme propriété KeyboardShortcut. |
| get_accName | La propriété nom est le texte de la fenêtre ou la 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 le même nom Nom propriété et 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 de suivantes:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Remarques
L’objet dialog ne prend pas en charge la méthode get_accChild. Pour obtenir un pointeur d’interface iAccessibleIAccessible 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.