Élément de menu (référence des éléments d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets d' élément de menu à des fins de référence d’élément d’interface utilisateur MSAA. La procédure de création d’objets d' é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 les 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 IAccessible
Un élément de menu prend en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| Obtient _ accChild | Récupère l’interface IDispatch de l’objet de menu contextuel pour cet élément. |
| Obtient _ 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. |
| Obtient _ accDefaultAction | La propriété DefaultAction pour les éléments de menu qui affichent un menu ou un sous-menu est soit « Open », soit « close » en fonction de l’état du menu. La propriété DefaultAction de tous les autres éléments de menu est « Execute ». |
| Obtient _ accFocus | |
| Obtient _ accKeyboardShortcut | La propriété KeyboardShortcut est la clé 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 menu fichier est « f ». |
| Obtient _ accName | La propriété Name est identique au nom de l’élément de menu. |
| Obtient _ accParent | La propriété parent est la barre de menus ou le menu contextuel qui contient l’élément de menu. |
| Obtient _ accRole | La propriété role est un système de rôle _ _ MenuItem. |
| Obtient _ accState | La propriété State est soit un système d’état _ _ invisible , soit une combinaison d’une ou plusieurs des valeurs suivantes : état _ système _ non disponible état système | _ _ activé état système | _ _ par défaut état système | _ _ HOTTRACKED | état _ _ système | _ _ 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 requiert la touche Maj ou une autre touche de modification. Cela se produit également sur les claviers internationaux avec un caractère de touche d’accès qui requiert l’appui sur la touche ALT GR.
- La méthode accSelect avec SELFLAG _ TAKEFOCUS ne provoque 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 retourne « application » pour la propriété Name au lieu du nom de l’élément de menu.