Implémentation du modèle de contrôle SelectionItem d’UI Automation
Remarque
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 |
|---|---|---|
| IsSelected | Property | Aucune |
| SelectionContainer | Property | Aucune |
| AddToSelection | Méthode | Aucune |
| RemoveFromSelection | Méthode | Aucune |
| Select | Méthode | Aucune |
| ElementSelectedEvent | événement | Déclenché lorsqu’une modification de sélection entraîne l’affichage d’un seul élément sélectionné. |
| ElementAddedToSelectionEvent | événement | Déclenché lorsqu’un élément est ajouté à un conteneur à sélection multiple. |
| ElementRemovedFromSelectionEvent | événement | Déclenché lorsqu’un élément est supprimé d’un conteneur à sélection multiple. |
| InvalidatedEvent | événement | Déclenché lorsqu’une sélection dans un conteneur a changé de manière significative et nécessite l’envoi de plus d'événements ElementSelectedEvent et ElementRemovedFromSelectionEvent que la constante InvalidateLimit n’autorise. |
- Si une opération Select, AddToSelectionou RemoveFromSelection aboutit à un seul élément sélectionné, déclenchez ElementSelectedEvent; sinon, déclenchez ElementAddedToSelectionEvent ou 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