Share via

Interface ISelectionProvider2 (uiautomationcore.h)

  • Article

Étend l’interface ISelectionItemProvider pour fournir des informations sur les éléments sélectionnés.

Héritage

L’interface ISelectionProvider2 hérite de l’interface ISelectionProvider.

Méthodes

L’interface ISelectionProvider2 a ces méthodes.

 
ISelectionProvider2 ::get_CurrentSelectedItem

Obtient l’élément actuellement sélectionné.
ISelectionProvider2 ::get_FirstSelectedItem

Obtient le premier élément d’un groupe d’éléments sélectionnés.
ISelectionProvider2 ::get_ItemCount

Obtient le nombre d’éléments sélectionnés.
ISelectionProvider2 ::get_LastSelectedItem

Obtient le dernier élément d’un groupe d’éléments sélectionnés.

Remarques

Cette interface est implémentée par un fournisseur microsoft UI Automation.

Les fournisseurs doivent déclencher un événement de type UIA_Selection_InvalidatedEventId lorsqu’une sélection dans un conteneur a considérablement changé.

Lors de la sélection à partir d’une liste ou d’une grille 2D, il existe des éléments d’information principaux que les AT souhaiteraient mieux lire à leurs utilisateurs finaux. En utilisant Excel comme exemple principal, il y a 4 main éléments d’information nécessaires à l’AT afin de fournir une bonne expérience :

  • Première cellule de la sélection
  • Dernière cellule de la sélection
  • L’élément actif que vous sélectionnez
  • Nombre total
Image d’une feuille de calcul Excel montrant plusieurs cellules sélectionnées. La sélection commence dans le coin supérieur droit de la cellule F5 et se termine dans le coin inférieur gauche de la cellule D7. L’image ci-dessus illustre l’état final d’une sélection 2D :
  • L’utilisateur a démarré dans la cellule F5 (notez que c’est là que l’entrée du focus reste, car si vous tapez c’est là que les données atterrissent)
  • L’utilisateur sélectionne la colonne vers la cellule F7
  • L’utilisateur sélectionne ensuite gauche à la cellule D7

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2016 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

ISelectionItemProvider

Vue d'ensemble des fournisseurs UI Automation