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

  • Article

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