Implementando o padrão de controle Toggle de automação de interface de usuário

Artigo
08/01/2011

Observação

Esta documentação destina.Os desenvolvedores do NET Framework que desejam usar o gerenciado UI Automation classes definidas na System.Windows.Automation namespace.As informações mais recentes sobre UI Automation, consulte API de automação do Windows: Automação da interface do usuário.

This topic introduces guidelines and conventions for implementing IToggleProvider, including information about methods and properties. Links to additional references are listed at the end of the topic.

The TogglePattern control pattern is used to support controls that can cycle through a set of states and maintain a state once set. For examples of controls that implement this control pattern, see Mapeamento de Padrão de Controles para Clientes de Automação de IU.

Este tópico contém as seguintes seções.

Implementation Guidelines and Conventions
Required Members for IToggleProvider
Exceptions
Tópicos relacionados

Implementation Guidelines and Conventions

When implementing the Toggle control pattern, note the following guidelines and conventions:

Controls that do not maintain state when activated, such as buttons, toolbar buttons, and hyperlinks, must implement IInvokeProvider instead.
Um controle deve percorrer suas ToggleState na seguinte ordem: On, Off e suporte, Indeterminate.
TogglePattern does not provide a SetState(newState) method due to issues surrounding the direct setting of a tri-state CheckBox without cycling through its appropriate ToggleState sequence.
The RadioButton control does not implement IToggleProvider, as it is not capable of cycling through its valid states.