Compartilhar via

Padrão de controle de alternância

  • Artigo

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

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

Diretrizes e convenções de implementação

Ao implementar o padrão de controle Alternar, observe as seguintes diretrizes e convenções:

  • Controles que não mantêm o estado quando ativados, como botões, botões de 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 houver suporte, ToggleState_Indeterminate.
  • Desativar não fornece um método de estado definido devido a problemas em torno da configuração direta de uma caixa de seleção de três estados sem percorrer sua sequência deToggleStateapropriada.
  • O controle de botão de opção 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 a interfaceIToggleProvider.

Membros necessários Tipo de membro Anotaçõ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 com suporte

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

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