Toolbar Control (MSAA UI Element Reference)
Note
Cette rubrique décrit 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 Toolbar Control dans diverses 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 contrôle de barre d’outils contient des boutons qui exécutent des commandes de menu et qui sont généralement contenus dans une fenêtre située sous la barre de menus.
Le nom de 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 IAccessible
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 est le 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 « Ouvrir » comme propriété DefaultAction. La propriété DefaultAction pour tous les autres boutons de barre d’outils est « Appuyer ». |
| 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 renvoie une chaîne non Null comme 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 de la légende). Ce texte n’est pas affiché avec la barre d’outils. Les développeurs de serveurs doivent donc 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 le même nom Name propriété et classe de fenêtre que le contrôle. |
| get_accRole | La propriété role est ROLE_SYSTEM_TOOLBAR. |
| get_accSelection | |
| get_accState | La valeur pour la propriété State de la barre d’outils elle-même est égale à 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 des événements EVENT_OBJECT_STATECHANGE.