Implémentation du modèle de contrôle SelectionItem d'UI Automation

Article
08/10/2011

Remarque
Cette documentation s'adresse aux développeurs .NET Framework qui veulent utiliser les classes UI Automation managées définies dans l'espace de noms System.Windows.Automation.Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation (page éventuellement en anglais).

Cette rubrique présente les conventions et directives à respecter pour implémenter ISelectionItemProvider, notamment les informations sur les propriétés, les méthodes et les événements. Des liens vers des références supplémentaires sont répertoriés à la fin de la vue d'ensemble.

Le modèle de contrôle SelectionItemPattern est utilisé pour prendre en charge les contrôles qui agissent comme les éléments enfants individuels et sélectionnables des contrôles conteneur qui implémentent ISelectionProvider. Pour obtenir des exemples de contrôles qui implémentent le modèle de contrôle SelectionItem, consultez Mappage de modèle de contrôle pour les clients UI Automation.

Cette rubrique comprend les sections suivantes.

Conventions et instructions de l'implémentation
Membres requis pour ISelectionItemProvider
Exceptions
Rubriques connexes

Conventions et instructions de l'implémentation

Lorsque vous implémentez le modèle de contrôle SelectionItem, notez les conventions et instructions suivantes :

Les contrôles à sélection unique qui gèrent des 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, doivent implémenter ISelectionProvider et leurs enfants doivent implémenter IRawElementProviderFragment et ISelectionItemProvider.

Membres requis pour ISelectionItemProvider

Les propriétés, les méthodes et les événements suivants sont nécessaires à l'implémentation de ISelectionItemProvider.

Membres requis	Type de membre	Remarques
CanSelectMultiple	Propriété	Aucun
IsSelectionRequired	Propriété	Aucun
GetSelection	Méthode	Aucun
InvalidatedEvent	Événement	Déclenché lorsqu'une sélection a changé de manière significative dans un conteneur et requiert l'envoi d'un plus grand nombre d'événements ElementSelectedEvent et ElementRemovedFromSelectionEvent que la constante InvalidateLimit ne le permet.

Si le résultat d'un Select, d'un AddToSelection ou d'un RemoveFromSelection est un unique élément sélectionné, vous devez déclencher un ElementSelectedEvent ; sinon envoyez ElementAddedToSelectionEvent ou ElementRemovedFromSelectionEvent selon le cas.

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d'exception	Condition
InvalidOperationException	Lorsque l'une des tentatives suivantes est effectuée : RemoveFromSelection est appelé dans un conteneur à sélection unique où IsSelectionRequiredProperty = true et où un élément est déjà sélectionné. RemoveFromSelection est appelé dans un conteneur à sélection multiple où IsSelectionRequiredProperty = true et où un seul élément est sélectionné. AddToSelection est appelé dans un conteneur à sélection unique où CanSelectMultipleProperty = false et où un autre élément est déjà sélectionné.

InvalidOperationException

Lorsque l'une des tentatives suivantes est effectuée :

RemoveFromSelection est appelé dans un conteneur à sélection unique où IsSelectionRequiredProperty = true et où un élément est déjà sélectionné.
RemoveFromSelection est appelé dans un conteneur à sélection multiple où IsSelectionRequiredProperty = true et où un seul élément est sélectionné.
AddToSelection est appelé dans un conteneur à sélection unique où CanSelectMultipleProperty = false et où un autre élément est déjà sélectionné.