contrôle List-View (référence de l’élément d’interface utilisateur MSAA)
Notes
Cette rubrique décrit les objets de contrôle List-View à des fins de référence d’élément d’interface utilisateur MSAA. La création d’objets List-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’affichage de liste affiche une collection d’éléments, chacun composé d’une icône et d’une étiquette, et offre 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. Windows Explorer utilise un contrôle d’affichage de liste pour afficher les fichiers.
Le nom de la classe window d’un contrôle list-view est WC_LISTVIEW, qui est défini comme « SysListView » dans Commctrl.h.
Méthodes IAccessible
Un contrôle list-view 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 IAccessibles
Un contrôle list-view prend en charge les propriétés IAccessible 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 de vue 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 de chaque élément de vue de liste est le texte contenu dans la deuxième colonne de l’élément et dans les colonnes suivantes. Une virgule est insérée entre le texte de chaque colonne. |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | Les objets List-views n’ont pas de raccourcis clavier. Toutefois, si le texte de la fenêtre du contrôle list-view contient un caractère ampersand (&), Microsoft Active Accessibility retourne une chaîne non Null en tant que propriété KeyboardShortcut . |
| get_accName | Le nom de l’objet list-view est obtenu à partir du texte de la fenêtre du contrôle (ou légende). Ce texte n’est pas affiché avec le contrôle list-view. 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. Pour les éléments d’affichage de liste, la propriété Name est le texte de l’élément de liste. |
| get_accParent | Le parent de l’objet list-view 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 des éléments list-view est l’objet list-view. |
| get_accRole | Le rôle de ROLE_SYSTEM_LIST, et chaque élément du contrôle list-view 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 des valeurs suivantes : STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN La propriété State des éléments list-view 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, case activée éléments d’affichage de liste de zone ont également l’état STATE_SYSTEM_CHECKED. |
Notes
- Microsoft Active Accessibility n’expose pas de texte d’élément 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 coupés n’ont pas STATE_SYSTEM_INVISIBLE défini. Pour déterminer si un élément de liste est coupé, 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 list-view qui se trouve 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 list-view dans la vue Détails, les coordonnées du rectangle englobant de l’élément récupérées par accLocation échouent si elles sont testées avec accHitTest , car accHitTest détermine les limites de l’objet pixel par pixel.