Implementando o padrão de controle de alternância de automação da interface do usuário
Nota
Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.
Este tópico apresenta diretrizes e convenções para implementação IToggleProvider, incluindo informações sobre métodos e propriedades. Links para referências adicionais estã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 obter exemplos de controles que implementam esse padrão de controle, consulte Mapeamento de padrão de controle para clientes de automação da interface do usuário.
Orientações e convenções de aplicação
Ao implementar o padrão de controle Toggle, observe as seguintes diretrizes e convenções:
Os controles que não mantêm o estado quando ativados, como botões, botões da barra de ferramentas e hiperlinks, devem ser implementados IInvokeProvider .
Um controlo deve percorrê-lo ToggleState pela seguinte ordem: On, Off e, se suportado, Indeterminate.
TogglePattern não fornece um método SetState(newState) devido a problemas relacionados à configuração direta de uma CheckBox de três estados sem percorrer sua 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 seguintes propriedades e métodos são necessários para a implementação do IToggleProvider.
| Membro obrigatório | Tipo de membro | Notas |
|---|---|---|
| Toggle | Método | Nenhuma |
| ToggleStateProperty | Property | Nenhuma |
Esse padrão de controle não tem eventos associados.
Exceções
Esse padrão de controle não tem exceções associadas.
Consulte também
- Visão geral dos padrões de controle de automação da interface do usuário
- Suporte a padrões de controle em um provedor de automação de interface do usuário
- Padrões de controle de automação da interface do usuário para clientes
- Obter o estado de alternância de uma caixa de seleção usando a automação da interface do usuário
- Visão geral da árvore de automação da interface do usuário
- Usar cache na automação da interface do usuário