Tree View Control (RÉFÉRENCE de l’élément d’interface utilisateur MSAA)
Note
Cette rubrique décrit objets de contrôle d’arborescence à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets Tree View Control 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.
Un contrôle d’arborescence affiche une liste hiérarchique d’éléments à l’aide de lignes pour connecter des éléments connexes dans une hiérarchie. Chaque élément se compose d’une étiquette et d’une bitmap facultative. L’Explorateur Windows utilise un contrôle d’arborescence pour afficher les répertoires.
Le nom de classe de fenêtre d’un contrôle d’arborescence est WC_TREEVIEW, qui est défini comme « SysTreeView » dans Commctrl.h.
Méthodes IAccessible
Un contrôle d’arborescence prend en charge les méthodes IAccessible suivantes :
| Méthode | Commentaires |
|---|---|
| accDoDefaultAction | L’objet tree view lui-même n’a pas de méthode accDoDefaultAction. Selon la propriété State d’un élément dans l’arborescence, accDoDefaultAction développe ou réduit l’élément spécifié. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propriétés IAccessible
Un contrôle d’arborescence prend en charge les propriétés deIAccessible suivantes:
| Propriété | Commentaires |
|---|---|
| get_accChild | |
| get_accChildCount | La propriété ChildCount de l’objet d’arborescence correspond au nombre d’éléments contenus dans l’arborescence. La propriété ChildCount pour chaque élément d’arborescence est égale à zéro. |
| get_accDefaultAction | L’objet tree view lui-même n’a pas de propriété DefaultAction. Un élément de l’arborescence développée a la valeur « Collapse » comme propriété DefaultAction et un élément qui n’est pas développé a « Expand » comme propriété DefaultAction. |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | |
| get_accName | La propriété Name de l’objet d’arborescence est obtenue à partir du texte de la fenêtre du contrôle (ou de la légende). Ce texte n’est pas affiché avec le contrôle d’arborescence. 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. La propriété Name d’un élément dans l’arborescence est le texte affiché dans l’élément d’arborescence. |
| get_accParent | La propriété Parent de l’objet d’arborescence 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. La propriété Parent de chaque élément de l’arborescence est l’objet d’arborescence. |
| get_accRole | L’objet d’arborescence a la propriété RoleROLE_SYSTEM_OUTLINE. Chaque élément de l’arborescence a la propriété RoleROLE_SYSTEM_OUTLINEITEM. |
| get_accSelection | |
| get_accState | La propriété State pour l’arborescence est une combinaison d’une ou plusieurs valeurs de suivantes: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE Pour les éléments d’arborescence, la propriété State inclut STATE_SYSTEM_EXPANDED ou STATE_SYSTEM_COLLAPSED. Les valeurs possibles supplémentaires pour la propriété State sont les suivantes : STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED |
| get_accValue | L’objet d’arborescence n’a pas de valeur. La propriété Value pour chaque élément d’arborescence correspond au niveau de retrait de l’élément dans la hiérarchie. Par exemple, dans l’Explorateur Windows, l’élément « Bureau » a une propriété Value de « 0 » ; l’élément « Mon ordinateur », qui se trouve au niveau suivant de la hiérarchie, a une propriété Value de « 1 » ; et chacun des lecteurs de disque, qui sont au niveau suivant de la hiérarchie, ont une propriété Value de « 2 ». |
Notes
La propriété accLocation des éléments d’arborescence retourne l’emplacement uniquement du texte de l’élément. Les coordonnées retournées par accLocation pour les éléments d’arborescence n’incluent pas l’icône située à gauche du texte.