Implementando o padrão de controle Toggle de automação de interface de usuário
Observação
Esta documentação destina-se a desenvolvedores de .NET Framework que querem usar as classes da Automação da Interface do Usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a Automação da Interface do Usuário, confira API de Automação do Windows: Automação da Interface do Usuário.
Este tópico apresenta diretrizes e convenções para implementação, incluindo IToggleProviderinformações sobre métodos e propriedades. Links para referências adicionais são listados no final do tópico.
O TogglePattern padrão de controle é usado para dar suporte a controles que podem percorrer um conjunto de estados e manter um estado uma vez definido. Para ver exemplos de controles que implementam esse padrão de controle, confira Mapeamento de padrões de controle para clientes da Automação da Interface do Usuário.
Diretrizes e convenções de implementação
Ao implementar o padrão de controle De alternância, observe as seguintes diretrizes e convenções:
Controles que não mantêm o estado quando ativados, como botões, botões da barra de ferramentas e hiperlinks, devem implementar IInvokeProvider.
Um controle deve percorrer a seguinte ToggleState ordem: OnOff e, se houver suporte, Indeterminate.
TogglePattern não fornece um método SetState(newState) devido a problemas em torno da configuração direta de uma Caixa de Seleção de três estados sem percorrer a sequência apropriada ToggleState.
O controle RadioButton não implementa IToggleProvider, pois não é capaz de percorrer seus estados válidos.
Membros necessários para IToggleProvider
As propriedades e os métodos a seguir são necessários para implementar IToggleProvider.
| Membro obrigatório | Tipo de membro | Observações |
|---|---|---|
| Toggle | Método | Nenhum |
| ToggleStateProperty | Propriedade | Nenhum |
Esse padrão de controle não tem eventos associados.
Exceções
Esse padrão de controle não tem exceções associadas.
Confira também
- Visão Geral de Padrões de Controle de Automação de Interface de Usuário
- Padrões de controle de suporte em um provedor de automação da interface do usuário
- Padrões de Controle para Clientes de Automação de IU
- Obter o estado Toggle de uma caixa de seleção usando automação de interface do usuário
- Visão geral da árvore de automação de interface do usuário
- Usar armazenamento em cache em automação de interface do usuário