Partager via


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

Notes

Cette documentation s’adresse aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les dernières informations sur UI Automation, consultez API Windows Automation : UI Automation.

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 permet de prendre en charge les contrôles qui agissent en tant qu’éléments enfants individuels et sélectionnables de contrôles conteneurs 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

Conventions et directives d'implémentation

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

Membres requis pour ISelectionItemProvider

Les propriétés, les méthodes et les événements suivants sont requis pour implémenter ISelectionItemProvider.

Membres nécessaires Type de membre Notes
CanSelectMultiple Propriété Aucun
IsSelectionRequired Propriété Aucun
GetSelection Méthode Aucun
InvalidatedEvent Événement Déclenché quand 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.

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d'exception Condition
InvalidOperationException Quand l’une des tentatives suivantes est effectuée :

- RemoveFromSelection est appelée sur un conteneur à sélection unique alors que IsSelectionRequiredProperty = true et qu’un élément est déjà sélectionné.
- RemoveFromSelection est appelée sur un conteneur à sélection multiple alors que IsSelectionRequiredProperty = true et qu’un seul élément est sélectionné.
- AddToSelection est appelée sur un conteneur à sélection unique alors que CanSelectMultipleProperty = false et qu’un autre élément est déjà sélectionné.

Voir aussi