Contrôle barre d’outils (référence de l’élément d’interface utilisateur MSAA)

  • Article

Notes

Cette rubrique décrit les objets De contrôle de barre d’outils à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets De contrôle de barre d’outils 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 contrôle de barre d’outils contient des boutons qui exécutent des commandes de menu et est généralement contenu dans une fenêtre située sous la barre de menus.

Le nom de la classe de fenêtre d’un contrôle de barre d’outils est TOOLBARCLASSNAME, qui est défini comme « ToolbarWindow32 » dans Commctrl.h.

Méthodes IAccessible

Un contrôle de barre d’outils prend en charge les méthodes IAccessible suivantes :

Méthode Commentaires
accDoDefaultAction La barre d’outils elle-même prend en charge la méthode accDoDefaultAction . Pour les boutons de la barre d’outils, accDoDefaultAction appelle PostMessage avec le message BM_CLICK pour cliquer sur le bouton spécifié.
accHitTest
accLocation
accNavigate
accSelect

Propriétés IAccessibles

Un contrôle de barre d’outils prend en charge les propriétés IAccessible suivantes :

Propriété Commentaires
get_accChild
get_accChildCount La propriété ChildCount correspond au nombre de contrôles contenus dans la barre d’outils.
get_accDefaultAction L’objet de barre d’outils lui-même n’a pas de propriété DefaultAction . La propriété DefaultAction pour les boutons de barre d’outils dépend du style de bouton de barre d’outils. Les boutons avec le style TBSTYLE_DROPDOWN ont « Open » comme propriété DefaultAction . La propriété DefaultAction pour tous les autres boutons de barre d’outils est « Appuyez ».
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut Les barres d’outils n’ont pas de raccourcis clavier. Toutefois, si le texte de la fenêtre de la barre d’outils contient un caractère ampersand (&), Microsoft Active Accessibility retourne une chaîne non Null en tant que propriété KeyboardShortcut .
get_accName La propriété Name de la barre d’outils est obtenue à partir du texte de la fenêtre du contrôle (ou légende). Ce texte n’étant pas affiché avec la barre d’outils, les développeurs de serveurs doivent fournir du texte explicite dans l’instruction de définition de ressource du contrôle pour aider les utilisateurs des utilitaires clients à identifier le contrôle. Le texte de la fenêtre peut être défini à l’aide de la fonction SetWindowText .
get_accParent La propriété Parent est une fenêtre ( ROLE_SYSTEM_WINDOW ) qui entoure le contrôle et a la même propriété Name et le même nom de classe de fenêtre que le contrôle.
get_accRole La propriété Role est ROLE_SYSTEM_TOOLBAR.
get_accSelection
get_accState La valeur de la propriété State pour la barre d’outils elle-même est zéro, ce qui signifie que l’objet est visible. Les valeurs possibles pour la propriété State des boutons de barre d’outils sont les suivantes : STATE_SYSTEM_INVISIBLE ou
| STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_MOVEABLE | STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE

Notes

Les boutons d’une barre d’outils envoient EVENT_OBJECT_STATECHANGE événements.

IAccessible Interface