Modèle de contrôle SelectionItem

Décrit des instructions et des conventions pour l’implémentation d’ISelectionItemProvider, y compris des informations sur les propriétés, les méthodes et les événements. Le modèle de contrôle SelectionItem est utilisé pour prendre en charge les contrôles qui agissent en tant qu’éléments enfants individuels et sélectionnables de contrôles de conteneur qui implémentent ISelectionProvider.

Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Types de contrôles et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

• Conventions et directives d'implémentation
• Membres obligatoires pour ISelectionItemProvider
• Rubriques connexes

Conventions et directives d'implémentation

Lors de l’implémentation du modèle de contrôle SelectionItem , notez les directives et conventions suivantes :

• Les contrôles à sélection unique qui gèrent les contrôles enfants qui implémentent IRawElementProviderFragmentRoot, tels que le curseur Résolution d’écran dans la boîte de dialogue Propriétés d’affichage pour Windows, doivent implémenter ISelectionProvider ; leurs enfants doivent implémenter À la fois IRawElementProviderFragment et ISelectionItemProvider.

Membres obligatoires pour ISelectionItemProvider

Les propriétés, méthodes et événements suivants sont nécessaires pour implémenter l’interface ISelectionItemProvider .

Membres nécessaires	Type de membre	Notes
AddToSelection	Méthode	Aucun
IsSelected	Propriété	Aucun
RemoveFromSelection	Méthode	Aucun
Sélectionner	Méthode	Aucun
SelectionContainer	Propriété	Aucun
UIA_SelectionItem_ElementAddedToSelectionEventId	Événement	Aucun
UIA_SelectionItem_ElementRemovedFromSelectionEventId	Événement	Aucun
UIA_SelectionItem_ElementSelectedEventId	Événement	Aucun

 

Si le résultat d’un élément Select, d’un AddToSelection ou d’un RemoveFromSelection est un seul élément sélectionné, un événement ElementSelected (UIA_SelectionItem_ElementSelectedEventId) doit être déclenché ; sinon, déclenchez les événements ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) ou ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) le cas échéant.

Rubriques connexes

Types de contrôles et leurs modèles de contrôle pris en charge

Vue d'ensemble des modèles de contrôle UI Automation

Vue d’ensemble de l’arborescence UI Automation