Implementando o padrão de controle de alternância de automação da interface do usuário

Observação

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 namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

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 Control Pattern Mapping for UI Automation Clients.

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 implementar IInvokeProvider em vez disso.

• Um controlo deve percorrer o ToggleState pela seguinte ordem: On, Off e, se for suportado, Indeterminate.

• TogglePattern não fornece um método SetState(newState) devido a problemas relacionados à configuração direta de um CheckBox de três estados sem percorrer a sequência apropriada ToggleState.

• O controlador RadioButton não implementa IToggleProvider, pois não é capaz de passar pelos 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	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.

Ver também

• Visão geral dos padrões de controle de automação da interface do usuário
• Suportar 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
• Use o armazenamento em cache na automação da interface do utilizador