Élément de menu (référence de l’élément d’interface utilisateur MSAA)
Note
Cette rubrique décrit objets d’é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 de 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éthodesIAccessible 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 dans un menu contextuel, accDoDefaultAction clique sur l’élément de menu pour exécuter la commande de menu. |
| accLocation | |
| accNavigate | |
| accSelect |
Propriétés IAccessible
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 à l’objet de menu contextuel de 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 » en fonction de l’état du menu. La propriété DefaultAction pour tous les autres éléments de menu est « Execute ». |
| 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 pour 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’elle est utilisée 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 de modificateur. Cela se produit également sur les claviers internationaux avec un caractère de touche d’accès qui nécessite que la touche GR alt soit enfoncée.
- La méthode accSelect avec SELFLAG_TAKEFOCUS n’entraîne pas l’ouverture ou la fermeture d’un menu contextuel. 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.