Zone de liste (référence d’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets List Box à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets List Box dans différents frameworks d’interface utilisateur n’est pas décrite ici. Consultez la documentation de référence sur les API pour l’infrastructure d’interface utilisateur que vous utilisez.
Les zones de liste affichent une liste à partir de laquelle un utilisateur peut sélectionner un ou plusieurs éléments. Une zone de liste est créée avec une barre de défilement verticale, une barre de contrôle horizontale ou les deux.
Le nom de la classe de fenêtre pour une zone de liste est « LISTBOX ».
IAccessible, méthodes
Les zones de liste prennent en charge les méthodes IAccessible suivantes :
| Méthode | Commentaires |
|---|---|
| accDoDefaultAction | L’objet de zone de liste lui-même n’a pas de propriété DefaultAction ; toutefois, accDoDefaultAction double-clique sur les éléments de la zone de liste. |
| accHitTest | La méthode accHitTest retourne zéro si le point testé se trouve dans la zone de liste, mais pas sur un élément de la zone de liste. Si le point testé se trouve sur un élément de la zone de liste, accHitTest retourne l’index de l’élément de zone de liste. |
| accLocation | |
| accNavigate | |
| accSelect |
Propriétés IAccessible
Les zones de liste prennent en charge les propriétés IAccessible suivantes :
| Propriété | Commentaires |
|---|---|
| get_accChild | La propriété ChildCount est le nombre d’éléments dans la zone de liste. |
| get_accDefaultAction | L’objet de zone de liste lui-même n’a pas de propriété DefaultAction ; Toutefois, la propriété DefaultAction pour chaque élément de liste est « Double-clic ». |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | La propriété KeyboardShortcut est la touche d’accès de la zone de liste, qui est un caractère souligné dans le texte de l’étiquette associée à la zone de liste. La chaîne retournée contient le caractère clé d’accès ajouté à la chaîne « Alt+ ». |
| get_accName | La propriété Name de l’objet de zone de liste est le texte d’un contrôle de texte statique qui étiquette la zone de liste. Pour les éléments de zone de liste, la propriété Name est le texte de l’élément de liste. |
| get_accParent | La propriété Parent est une fenêtre ( ROLE_SYSTEM_WINDOW ) qui entoure la zone de liste et a la même propriété Name et le même nom de classe de fenêtre que la zone de liste. La propriété Parent des éléments de zone de liste est l’objet de zone de liste. |
| get_accRole | La propriété Role est ROLE_SYSTEM_LIST. Les éléments de la zone de liste ont la propriété Rolede ROLE_SYSTEM_LISTITEM. |
| get_accSelection | La propriété Selection récupère les éléments sélectionnés dans la zone de liste. |
| get_accState | La propriété State de l’objet zone de liste est une combinaison d’une ou plusieurs des valeurs suivantes : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN La propriété State de l’élément de zone de liste est une combinaison d’une ou plusieurs des valeurs suivantes : | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_NORMAL |