Contrôle Tree View (référence de l’élément d’interface utilisateur MSAA)

  • Article

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.

IAccessible Interface