Zone de liste modifiable (référence d’élément d’interface utilisateur MSAA)
Note
Cette rubrique décrit zone de liste déroulante objets à des fins de référence d’élément d’interface utilisateur MSAA. La création d'zone de liste déroulante objets dans différents frameworks 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.
Une zone de liste modifiable est une zone de liste combinée à un contrôle statique ou un contrôle d’édition qui affiche l’élément actuellement sélectionné dans la partie zone de liste déroulante de la zone de liste modifiable. La partie zone de liste du contrôle s’affiche à tout moment ou uniquement dans la liste déroulante lorsque l’utilisateur sélectionne la flèche déroulante (qui est un bouton push) en regard du contrôle. Si le champ de sélection est un contrôle d’édition, l’utilisateur peut entrer des informations non dans la liste ; sinon, l’utilisateur ne peut sélectionner que des éléments dans la liste.
Le nom de la classe de fenêtre d’une zone de liste modifiable est « COMBOBOX ».
Le contenu des propriétés IAccessible dépend des parties suivantes de la zone de liste déroulante interrogée par le client :
- Fenêtre de zone de liste modifiable
- Contrôle d’édition ou contrôle de texte statique
- Flèche déroulante (qui est un bouton push)
- Zone de liste
- Éléments de liste dans la zone de liste
Méthodes IAccessible
Les zones de liste modifiable prennent en charge les méthodes IAccessible suivantes :
Propriétés IAccessible
Les zones de liste modifiable prennent en charge les propriétés IAccessible suivantes :
get_accChildCount: le tableau suivant montre la valeur du nombre d’enfants pour différentes parties de la zone de liste déroulante.
Partie zone de liste modifiable ChildCount Fenêtre zone de liste modifiable 3 Modifier le contrôle 0 Flèche déroulante 0 Zone de liste Nombre d’éléments de liste Élément de liste 0 get_accDefaultAction: le tableau suivant montre la propriété DefaultAction pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable DefaultAction Fenêtre zone de liste modifiable Aucun Modifier le contrôle Aucun Flèche déroulante « Ouvrir » ou « Fermer » en fonction de l’état de la liste déroulante Zone de liste Aucun Élément de liste « Double-clic » get_accKeyboardShortcut: le tableau suivant montre la propriété KeyboardShortcut pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable KeyboardShortcut Fenêtre zone de liste modifiable Clé d’accès de l’étiquette associée Modifier le contrôle Aucun Flèche déroulante « Alt+Flèche vers le bas » Zone de liste Aucun Élément de liste Aucun La clé d’accès d’une zone de liste modifiable est le caractère souligné dans le texte d’un contrôle de texte statique associé qui étiquette la zone de liste déroulante. Par exemple, dans une boîte de dialogue Ouvrir standard qui ouvre des fichiers, comme dans Microsoft WordPad, la zone de liste modifiable intitulée « Fichiers de type : » a la KeyboardShortcut « Alt+t ».
get_accName: le tableau suivant montre la propriété Name pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable Nom Fenêtre zone de liste modifiable Contrôle de texte statique utilisé comme étiquette Modifier le contrôle Contrôle de texte statique utilisé comme étiquette Flèche déroulante « Ouvrir » ou « Fermer » en fonction de l’état de la liste déroulante Zone de liste Étiquette associée Élément de liste Texte de l’élément de liste La propriété Name d’une zone de liste modifiable, son contrôle d’édition enfant et sa zone de liste enfant est le texte d’un contrôle de texte statique associé qui étiquette la zone de liste modifiable. Par exemple, dans une boîte de dialogue Ouvrir standard qui ouvre des fichiers, comme dans WordPad, les propriétés Name pour les deux zones de liste modifiable sont « Look in : » et « Files of type : ».
get_accParent: le tableau suivant montre la valeur parente pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable Parent Fenêtre zone de liste modifiable Fenêtre avec la propriété Role de ROLE_SYSTEM_WINDOW qui entoure la zone de liste déroulante et a le même nom Name propriété et nom de classe de fenêtre que la zone de liste déroulante. Modifier le contrôle (ou le contrôle de texte statique) Fenêtre de zone de liste modifiable. Flèche déroulante Fenêtre de zone de liste modifiable. Fenêtre parente de la zone de liste Fenêtre de zone de liste modifiable. Cette fenêtre entoure la zone de liste. Zone de liste Fenêtre parente de la zone de liste. Élément de liste Zone de liste. get_accRole: le tableau suivant montre la propriété Role pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable rôle Fenêtre zone de liste modifiable ROLE_SYSTEM_COMBOBOX Modifier le contrôle (ou le contrôle de texte statique) ROLE_SYSTEM_TEXT ou ROLE_SYSTEM_STATICTEXT Flèche déroulante ROLE_SYSTEM_PUSHBUTTON Zone de liste ROLE_SYSTEM_LIST Élément de liste ROLE_SYSTEM_LISTITEM get_accState: le tableau suivant montre la propriété State pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable États possibles Fenêtre zone de liste modifiable STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL | STATE_SYSTEM_EXPANDED | STATE_SYSTEM_COLLAPSED Modifier le contrôle STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL Flèche déroulante 0, ce qui signifie que le bouton est visible et non appuyé ; ou STATE_SYSTEM_PRESSED | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_NORMAL Zone de liste STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATING | STATE_SYSTEM_NORMAL Élément de liste STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_NORMAL get_accValue: le tableau suivant montre la propriété valeur pour différentes parties d’une zone de liste déroulante.
Partie zone de liste modifiable Valeur Fenêtre zone de liste modifiable Texte de l’élément de liste actuellement sélectionné Modifier le contrôle Texte de l’élément de liste actuellement sélectionné Flèche déroulante Aucun Zone de liste Aucun Élément de liste Aucun
Notes
- Lorsque accNavigate est appelée avec l’indicateur de NAVDIR_NEXT dans la partie zone de liste déroulante d’une zone de liste modifiable, il accède incorrectement à la fenêtre de barre d’état lorsqu’elle doit retourner VT_EMPTY.
Rubriques connexes