É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.

IAccessible, interface

Barre de menus

Menu contextuel