Barre de titre (référence de l’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets de barre de titre à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets de barre de titre 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.
La barre de titre en haut d’une fenêtre affiche une icône et une ligne de texte définies par l’application. 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, agrandissent ou restaurent et ferment la fenêtre associée à la barre de titre. Les barres de titre contiennent également un bouton Aide sensible au contexte. Les applications qui s’exécutent 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 IAccessibles
Les barres de titre prennent en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChildCount | La propriété ChildCount est 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 propriété Description de la barre de titre elle-même est la suivante : « Affiche le nom de la fenêtre et contient des contrôles pour la 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 portent les noms suivants :
|
| get_accParent | La propriété Parent de la barre de titre est la main fenêtre d’application ( ROLE_SYSTEM_WINDOW ) qui a le même nom de classe de fenêtre défini 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 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é StateSTATE_SYSTEM_FOCUSABLE, elle n’a jamais l’indicateur d’étatSTATE_SYSTEM_FOCUSED. La définition du focus sur un objet de barre de titre concentre la fenêtre d’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 eux-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 aucune action par défaut, les méthodes accDoDefaultAction et get_accDefaultAction ne sont pas prises en charge pour ce contrôle.