Contrôle Tree View (référence de l’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets Tree View Control à 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 sur 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 les éléments associés dans une hiérarchie. Chaque élément se compose d’une étiquette et d’une bitmap facultative. Windows Explorer utilise un contrôle d’arborescence pour afficher les répertoires.
Le nom de la 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 arborescence lui-même n’a pas de méthode accDoDefaultAction . En fonction de 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 IAccessibles
Un contrôle d’arborescence prend en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChild | |
| get_accChildCount | La propriété ChildCount de l’objet arborescence est le 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 arborescence lui-même n’a pas de propriété DefaultAction . Un élément dans l’arborescence développée a « 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 légende). Ce texte n’est pas affiché avec le contrôle d’arborescence. Les développeurs serveur doivent donc fournir un 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 arborescence 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. La propriété Parent de chaque élément de l’arborescence est l’objet 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 des valeurs 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 est le niveau de retrait de l’élément dans la hiérarchie. Par exemple, dans Windows Explorer, l’élément « Desktop » a une propriété Value « 0 » ; l’élément « Poste de travail », qui se trouve au niveau suivant de la hiérarchie, a une propriété Value de « 1 » ; et chacun des lecteurs de disque, qui se trouvent au niveau suivant dans la hiérarchie, a une propriété Value de « 2 ». |
Notes
La propriété accLocation des éléments d’arborescence retourne uniquement l’emplacement du texte dans 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.