Contrôle barre d’outils (référence de l’élément d’interface utilisateur MSAA)
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.