Partager via

Zone de liste déroulante (référence d’élément d’interface utilisateur MSAA)

  • Article

Notes

Cette rubrique décrit les objets Combo Box à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets Combo 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.

 

Une zone de liste modifiable est une zone de liste associée à un contrôle statique ou à un contrôle d’édition qui affiche dans la zone de liste l’élément actuellement sélectionné. La partie zone de liste du contrôle s’affiche à tout moment ou uniquement lorsque l’utilisateur sélectionne la flèche déroulante (qui est un bouton pousseur) en regard du contrôle. Si le champ de sélection est un contrôle d’édition, l’utilisateur peut entrer des informations qui ne se trouvent pas dans la liste . sinon, l’utilisateur peut sélectionner uniquement les éléments de 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 de laquelle des parties suivantes de la zone de liste modifiable est interrogée par le client :

  • Fenêtre zone de liste modifiable
  • Contrôle d’édition ou contrôle de texte statique
  • Flèche déroulante (qui est un bouton pousseur)
  • Zone de liste
  • Éléments de liste dans la zone de liste

IAccessible, méthodes

Les zones de liste déroulante prennent en charge les méthodes IAccessible suivantes :

Propriétés IAccessible

Les zones de liste déroulante prennent en charge les propriétés IAccessible suivantes :

  • get_accChild

  • get_accChildCount : le tableau suivant montre la valeur du nombre d’enfants pour les différentes parties de la zone de liste déroulante.

    Composant zone de liste déroulante ChildCount
    Fenêtre zone de liste modifiable 3
    Contrôle Edit 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.

    Composant zone de liste déroulante DefaultAction
    Fenêtre zone de liste modifiable Aucune
    Contrôle Edit None
    Flèche déroulante « Ouvrir » ou « Fermer » en fonction de l’état de la liste déroulante
    Zone de liste None
    Élément de liste « Double-clic »

     

  • get_accDescription

  • get_accFocus

  • get_accHelp

  • get_accHelpTopic

  • get_accKeyboardShortcut : le tableau suivant montre la propriété KeyboardShortcut pour différentes parties d’une zone de liste déroulante.

    Composant zone de liste déroulante KeyboardShortcut
    Fenêtre zone de liste modifiable Clé d’accès de l’étiquette associée
    Contrôle Edit None
    Flèche déroulante « Alt+Flèche bas »
    Zone de liste None
    Élément de liste Aucune

     

    La clé d’accès d’une zone de liste déroulante 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, par exemple dans Microsoft WordPad, la zone de liste déroulante intitulée « Fichiers de type : » a la touche KeyboardShortcut « Alt+t ».

  • get_accName : le tableau suivant montre la propriété Name pour différentes parties d’une zone de liste déroulante.

    Composant zone de liste déroulante Nom
    Fenêtre zone de liste modifiable Contrôle de texte statique utilisé comme étiquette
    Contrôle Edit 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 déroulante, 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 déroulante. Par exemple, dans une boîte de dialogue Ouvrir standard qui ouvre des fichiers, comme dans WordPad, les propriétés Nom des deux zones de liste déroulante sont « Regarder dans : » et « Fichiers de type : ».

  • get_accParent : le tableau suivant montre la valeur parente des différentes parties d’une zone de liste déroulante.

    Composant zone de liste déroulante Parent
    Fenêtre zone de liste modifiable Une fenêtre avec la propriété Role de ROLE_SYSTEM_WINDOW qui entoure la zone de liste déroulante et a la même propriété Name et le même nom de classe de fenêtre que la zone de liste déroulante.
    Contrôle de modification (ou 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.

    Composant zone de liste déroulante Rôle
    Fenêtre zone de liste modifiable ROLE_SYSTEM_COMBOBOX
    Contrôle de modification (ou 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.

    Composant zone de liste déroulante É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
    Contrôle Edit | 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 n’est pas appuyé; ou STATE_SYSTEM_INVISIBLE STATE_SYSTEM_PRESSED | | 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é Value pour différentes parties d’une zone de liste déroulante.

    Composant zone de liste déroulante Valeur
    Fenêtre zone de liste modifiable Texte de l’élément de liste actuellement sélectionné
    Contrôle Edit Texte de l’élément de liste actuellement sélectionné
    Flèche déroulante None
    Zone de liste None
    Élément de liste None

     

Notes

  • Quand accNavigate est appelé avec l’indicateur NAVDIR_NEXT dans la partie de zone de liste d’une zone de liste modifiable, il accède incorrectement à la fenêtre de la barre d’état lorsqu’il doit retourner VT_EMPTY.

IAccessible Interface