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 :
- 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 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. |
- Si le résultat d’une méthode Select, AddToSelectionou RemoveFromSelection est un élément sélectionné unique, vous devez déclencher un ElementSelectedEvent . Sinon, envoyez ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent selon le cas.
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
- Vue d'ensemble des modèles de contrôle UI Automation
- Prendre en charge des modèles de contrôle dans un fournisseur UI Automation
- Modèles de contrôle UI Automation pour les clients
- Implémentation du modèle de contrôle Selection d’UI Automation
- Vue d’ensemble de l’arborescence UI Automation
- Utiliser la mise en cache dans UI Automation
- Exemple de fournisseur de fragments