Compartilhar via


Alternar Padrão de Controle

Descreve as diretrizes e convenções para implementar o IToggleProvider, incluindo informações sobre propriedades e métodos. O padrão de controle De alternância é 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 inclui as seções a seguir.

Diretrizes e convenções de implementação

Ao implementar o padrão de controle De alternância , 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.
  • A alternância não fornece um método de estado definido devido a problemas em torno da configuração direta de uma caixa de marcar de três estados sem percorrer a sequência toggleState apropriada.
  • 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 interface IToggleProvider .

Membros necessá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 com suporte

Visão Geral de Padrões de Controle de Automação de Interface de Usuário

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