List-View Control (référence d’élément d’interface utilisateur MSAA)
Note
Cette rubrique décrit List-View objets control à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets List-View Control 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.
Un contrôle d’affichage de liste affiche une collection d’éléments, chacune composée d’une icône et d’une étiquette, et fournit plusieurs façons d’afficher et d’organiser les éléments. Par exemple, des informations supplémentaires sur chaque élément sont affichées dans des colonnes à droite de l’icône et de l’étiquette. L’Explorateur Windows utilise un contrôle d’affichage de liste pour afficher les fichiers.
Le nom de classe de fenêtre d’un contrôle list-view est WC_LISTVIEW, qui est défini comme « SysListView » dans Commctrl.h.
Méthodes IAccessible
Un contrôle d’affichage de liste prend en charge les méthodes IAccessible suivantes :
| Méthode | Commentaires |
|---|---|
| accDoDefaultAction | L’objet list-view lui-même n’a pas de propriété DefaultAction ; Toutefois, la méthode accDoDefaultAction double-clique sur les éléments d’affichage de liste. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propriétés IAccessible
Un contrôle d’affichage de liste prend en charge les propriétés deIAccessible suivantes:
| Propriété | Commentaires |
|---|---|
| get_accChild | |
| get_accChildCount | La propriété ChildCount correspond au nombre d’éléments de la liste. |
| get_accDefaultAction | L’objet list-view lui-même n’a pas de propriété DefaultAction ; Toutefois, la propriété DefaultAction pour chaque élément d’affichage de liste est « Double-clic ». |
| get_accDescription | L’objet list-view lui-même ne prend pas en charge la propriété Description ; Toutefois, la propriété Description pour chaque élément d’affichage de liste est le texte contenu dans les colonnes suivantes et secondes de l’élément. Une virgule est insérée entre le texte de chaque colonne. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Les objets affichages de liste n’ont pas de raccourcis clavier. Toutefois, si le texte de la fenêtre du contrôle d’affichage liste contient un caractère ampersand (&), Microsoft Active Accessibility renvoie une chaîne non Null comme propriété KeyboardShortcut. |
| get_accName | Le Name de l’objet d’affichage de liste est obtenu à partir du texte de la fenêtre du contrôle (ou de la légende). Ce texte n’est pas affiché avec le contrôle d’affichage de liste. Les développeurs de serveurs doivent donc fournir du texte explicite dans l’instruction de définition de ressource du contrôle pour aider les utilisateurs des utilitaires clients à identifier le contrôle. Pour les éléments d’affichage de liste, la propriété name est le texte de l’élément de liste. |
| get_accParent | L'Parent de l’objet d’affichage de liste est une fenêtre (ROLE_SYSTEM_WINDOW) qui entoure le contrôle et a le même nom Name propriété et classe de fenêtre que le contrôle. La propriété Parent des éléments d’affichage de liste est l’objet list-view. |
| get_accRole | Le rôle de ROLE_SYSTEM_LIST, et chaque élément du contrôle d’affichage de liste a la propriété Role de ROLE_SYSTEM_LISTITEM. |
| get_accSelection | |
| get_accState | La propriété State de l’objet list-view est une combinaison d’une ou plusieurs valeurs de suivantes: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN La propriété State des éléments d’affichage de liste est une combinaison d’une ou plusieurs des valeurs suivantes : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN | STATE_SYSTEM_NORMAL En outre, les éléments de liste de liste à cocher ont également l’état STATE_SYSTEM_CHECKED. |
Notes
- Microsoft Active Accessibility n’expose pas de texte d’élément d’affichage de liste dans les applications qui utilisent une fonction de rappel pour ajouter le texte à l’élément.
- Les éléments d’affichage de liste qui sont clippés n’ont pas STATE_SYSTEM_INVISIBLE défini. Pour déterminer si un élément de liste est clippé, les clients peuvent comparer les coordonnées de l’élément retournées par accLocation avec la zone de découpage de la fenêtre.
- Microsoft Active Accessibility ne prend pas en charge l’utilisation de la méthode accNavigate pour accéder au contrôle d’en-tête dans un contrôle d’affichage de liste qui est en mode Détails. Toutefois, les clients utilisent la fonction AccessibleObjectFromPoint pour accéder au contrôle d’en-tête.
- Pour les objets non rectangulaires tels que les éléments d’affichage de liste dans la vue Détails, les coordonnées du rectangle englobant de l’élément récupérés par accLocation échouent si elles sont testées avec accHitTest, car accHitTest détermine les limites de l’objet sur une base de pixels par pixels.