Implementando o padrão de controle Toggle de automação de interface de 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 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 obter exemplos de controles que implementam esse padrão de controle, consulte mapeamento de padrões de controle para clientes de automação de 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:

• Os controles que não mantêm estado quando ativados, como botões, botões da barra de ferramentas e hiperlinks, devem utilizar IInvokeProvider em vez disso.

• Um controle deve percorrer suas ToggleState na seguinte ordem: On, Off 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.

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
• 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 de ativação de uma caixa de seleção usando automação de UI
• Visão geral da árvore de automação da interface do usuário
• Usar armazenamento em cache em automação de interface do usuário