Partilhar via


Alternar padrão de controle

Descreve diretrizes e convenções para implementar IToggleProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Toggle é 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 tipos de controle e seus padrões de controle suportados.

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

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.
  • Um controle deve percorrer seus estados de alternância (ToggleState) na seguinte ordem: ToggleState_On, ToggleState_Off e, se suportado, ToggleState_Indeterminate.
  • de alternância não fornece um método de estado de conjunto devido a problemas relacionados à configuração direta de uma caixa de seleção de três estados sem percorrer sua sequênciaToggleState apropriada.
  • O controle de botão de opção não implementa IToggleProvider, porque ele não é capaz de percorrer seus estados válidos.

Membros necessários para IToggleProvider

As propriedades e métodos a seguir são necessários para implementar o IToggleProvider interface.

Membros obrigatórios Tipo de membro Observações
Alternar Método Nenhum
ToggleState Propriedade Nenhum

 

Esse padrão de controle não tem eventos associados.

tipos de controle e seus padrões de controle suportados

Visão geral dos padrões de controle de automação da interface do do usuário

Visão geral da árvore de automação da interface do usuário