Barre de titre (référence de l’élément d’interface utilisateur MSAA)
Note
Cette rubrique décrit objets de barre de titre à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets barre de titre dans différentes 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.
La barre de titre en haut d’une fenêtre affiche une icône définie par l’application et une ligne de texte. Le texte spécifie le nom de l’application et indique l’objectif de la fenêtre. La barre de titre permet également à l’utilisateur de déplacer la fenêtre à l’aide d’une souris ou d’un autre appareil pointant.
Les barres de titre contiennent au moins trois petits boutons qui réduisent, optimisent ou restaurent et ferment la fenêtre associée à la barre de titre. Les barres de titre contiennent également un bouton d’aide sensible au contexte. Les applications s’exécutant dans la version Far-East du système d’exploitation Windows peuvent également contenir des boutons IME (Input Method Editor). Microsoft Active Accessibility expose ces boutons en tant qu’éléments enfants de la barre de titre.
Méthodes IAccessible
Les barres de titre prennent en charge les méthodes IAccessible suivantes :
Propriétés IAccessible
Les barres de titre prennent en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChildCount | La propriété ChildCount est de cinq. La propriété ChildCount inclut les boutons d’aide IME et contextuels, même s’ils ne sont pas affichés. Les boutons qui ne sont pas affichés ont la propriété StateSTATE_SYSTEM_INVISIBLE. |
| get_accDescription | La Description propriété de la barre de titre elle-même est : « Affiche le nom de la fenêtre et contient des contrôles pour le manipuler ». Les boutons enfants de la barre de titre ont les descriptions suivantes :
|
| get_accName | La barre de titre elle-même ne prend pas en charge la propriété Name. Les boutons enfants de la barre de titre ont les noms suivants :
|
| get_accParent | La propriété Parent de la barre de titre est la fenêtre d’application principale (ROLE_SYSTEM_WINDOW) qui a le même nom de classe de fenêtre définie par l’application que la barre de titre. |
| get_accRole | La propriété Role est ROLE_SYSTEM_TITLEBAR. Les boutons enfants de la barre de titre ont la propriété RoleROLE_SYSTEM_PUSHBUTTON. |
| get_accState | La propriété State pour la barre de titre et les boutons enfants peuvent être une combinaison d’une ou plusieurs des valeurs de suivantes: STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_INVISIBLE STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_PRESSED |
| get_accValue | La propriété Value est une chaîne identique au texte affiché dans la barre de titre. |
Notes
- Bien que la barre de titre d’une application ait l’indicateur de propriété étatSTATE_SYSTEM_FOCUSABLE, il n’a jamais l’indicateur d’étatSTATE_SYSTEM_FOCUSED. La définition du focus sur un objet de barre de titre met l’accent sur la fenêtre de l’application.
- Étant donné que l’objet barre de titre ne prend pas en charge get_accChild, les boutons de la barre de titre sont des éléments simples. Ils ne prennent pas en charge l’interface IAccessible elles-mêmes. L’objet de barre de titre fournit des informations sur ces boutons enfants.
- Étant donné que les barres de titre n’obtiennent pas le focus et n’ont pas d’action par défaut, les méthodes accDoDefaultAction et get_accDefaultAction ne sont pas prises en charge pour ce contrôle.