Implémentation du modèle de contrôle Toggle 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 instructions à 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 TogglePattern modèle de contrôle est utilisé pour prendre en charge les contrôles qui peuvent parcourir un ensemble d'états et conserver un état une fois défini. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Mappage de modèle de contrôle pour les clients UI Automation.

Cette rubrique comprend les sections suivantes.

Conventions et instructions d'implémentation
Membres requis pour IToggleProvider
Exceptions
Rubriques connexes

Conventions et instructions d'implémentation

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

Les contrôles qui ne conservent pas l'état lorsqu'ils sont activés, tels que les boutons, les boutons de barre d'outils et les liens hypertexte, doivent implémenter IInvokeProvider à la place.
Un contrôle doit parcourir son ToggleState dans l'ordre suivant : On, Off et, s'il est pris en charge, Indeterminate.
TogglePattern ne fournit pas de méthode SetState (newState) en raison des 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 RadioButton n'implémente pas IToggleProvider, car il n'est pas capable de parcourir ses états valides.