Implémentation du modèle de contrôle Toggle 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 recommandations à respecter pour implémenter IToggleProvider, notamment des informations sur les méthodes et les propriétés. Des liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.
Le modèle de contrôle TogglePattern est utilisé pour prendre en charge les contrôles qui peuvent passer par un ensemble d’états, et conserver un état une fois ce dernier défini. Pour obtenir des exemples de contrôles implémentant ce modèle de contrôle, consultez Control Pattern Mapping for UI Automation Clients.
Conventions et directives d'implémentation
Quand vous implémentez le modèle de contrôle Toggle, notez les conventions et recommandations suivantes :
Les contrôles qui ne conservent pas l’état une fois ce dernier activé, par exemple les boutons, les boutons de barre d’outils et les liens hypertexte, doivent implémenter IInvokeProvider à la place.
Un contrôle doit parcourir ToggleState dans l’ordre suivant : On, Off et, si cela est pris en charge, Indeterminate.
TogglePattern ne fournit pas de méthode SetState(newState) en raison de problèmes liés à la définition directe d’une case à cocher à trois états sans parcourir sa séquence ToggleState appropriée.
Le contrôle de type RadioButton n’implémente pas IToggleProvider, car il n’est pas capable de parcourir ses états valides.
Membres obligatoires pour IToggleProvider
Les propriétés et méthodes suivantes sont nécessaires à l'implémentation d' IToggleProvider.
| Membre obligatoire | Type de membre | Notes |
|---|---|---|
| Toggle | Méthode | Aucun |
| ToggleStateProperty | Propriété | Aucun |
Ce modèle de contrôle n’est associé aucun événement.
Exceptions
Ce modèle de contrôle n’est associé à aucune exception.
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
- Obtenir l'état bascule d'une case à cocher à l'aide d'UI Automation
- Vue d’ensemble de l’arborescence UI Automation
- Utiliser la mise en cache dans UI Automation