Élément de menu (référence de l’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets Élément de menu à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets Élément de menu dans différentes infrastructures d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence sur l’API pour l’infrastructure d’interface utilisateur que vous utilisez.
Un élément de menu représente un élément particulier dans une barre de menus ou un menu contextuel. Par exemple, Microsoft Active Accessibility crée un objet d’élément de menu pour le menu Fichier dans la barre de menus. De même, Microsoft Active Accessibility crée un objet d’élément de menu pour l’élément de menu Ouvrir à partir du menu contextuel Fichier .
Le nom de la classe de fenêtre d’un élément de menu est « #32768 ».
Méthodes IAccessible
Un élément de menu prend en charge les méthodes IAccessible suivantes :
| Méthode | Commentaires |
|---|---|
| accDoDefaultAction | Pour les éléments de menu de la barre de menus, accDoDefaultAction affiche ou ferme le menu en fonction de l’état du menu. Pour les éléments de menu d’un menu contextuel, accDoDefaultAction clique sur l’élément de menu pour exécuter la commande de menu. |
| acchittest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propriétés IAccessibles
Un élément de menu prend en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChild | Récupère l’interface IDispatch dans l’objet de menu contextuel pour cet élément. |
| get_accChildCount | La propriété ChildCount est une pour les éléments de menu qui affichent un menu ou un sous-menu ; sinon, la propriété ChildCount est égale à zéro. |
| get_accDefaultAction | La propriété DefaultAction pour les éléments de menu qui affichent un menu ou un sous-menu est « Ouvrir » ou « Fermer », selon l’état du menu. La propriété DefaultAction pour tous les autres éléments de menu est « Exécuter ». |
| get_accFocus | |
| get_accKeyboardShortcut | La propriété KeyboardShortcut est la touche d’accès de l’élément de menu, qui est le caractère souligné dans le texte du nom de l’élément de menu. Par exemple, la propriété KeyboardShortcut de l’élément de menuFile est « f ». |
| get_accName | La propriété Name est identique au nom de l’élément de menu. |
| get_accParent | La propriété Parent est la barre de menus ou le menu contextuel qui contient l’élément de menu. |
| get_accRole | La propriété Role est ROLE_SYSTEM_MENUITEM. |
| get_accState | La propriété State est STATE_SYSTEM_INVISIBLE ou une combinaison d’une ou plusieurs des valeurs suivantes : STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_CHECKED | STATE_SYSTEM_DEFAULT | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_HASPOPUP |
Notes
- Lorsqu’il est utilisé sur un élément de menu, accDoDefaultAction retourne S_OK mais ne parvient pas à effectuer l’action si le caractère utilisé dans la clé d’accès est ?, !, @, ou tout autre caractère qui nécessite la touche MAJ ou une autre touche modificateur. Cela se produit également sur les claviers internationaux avec un caractère de touche d’accès qui nécessite d’appuyer sur la touche ALT GR.
- La méthode accSelect avec SELFLAG_TAKEFOCUS n’entraîne pas l’ouverture ou la fermeture d’un menu contextuel par un élément de menu. Les clients utilisent la méthode accDoDefaultAction pour ouvrir ou fermer un menu contextuel.
- Un élément de barre de menus qui n’affiche pas de menu contextuel renvoie « Application » pour la propriété Name au lieu du nom de l’élément de menu.