Condividi tramite

Attiva/Disattiva pattern di controllo

  • Articolo

Vengono descritte le linee guida e le convenzioni per l'implementazione di IToggleProvider, incluse informazioni su proprietà e metodi. Il Attiva/Disattiva pattern di controllo viene usato per supportare i controlli che possono scorrere un set di stati e mantenere uno stato una volta impostato.

Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.

Questo argomento contiene le sezioni seguenti.

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo attiva/disattiva, tenere presenti le linee guida e le convenzioni seguenti:

  • I controlli che non mantengono lo stato quando sono attivati, ad esempio pulsanti, pulsanti della barra degli strumenti e collegamenti ipertestuali, devono implementare IInvokeProvider.
  • Un controllo deve scorrere gli stati di attivazione/disattivazione (ToggleState) nell'ordine seguente: ToggleState_On, ToggleState_Off e, se supportato, ToggleState_Indeterminate.
  • Attiva/disattiva non fornisce un metodo di stato impostato a causa di problemi relativi all'impostazione diretta di una casella di controllo a tre stati senza eseguire il ciclo attraverso la sequenza diToggleState appropriata.
  • Il controllo pulsante di opzione non implementa IToggleProvider, perché non è in grado di eseguire il ciclo attraverso gli stati validi.

Membri obbligatori per IToggleProvider

Per implementare l'interfaccia IToggleProvider sono necessari i metodi e le proprietà seguenti.

Membri obbligatori Tipo di membro Note
Attiva/Disattiva Metodo Nessuno
ToggleState Proprietà Nessuno

 

Questo pattern di controllo non ha eventi associati.

tipi di controllo e i relativi modelli di controllo supportati

Panoramica modelli di controllo di automazione interfaccia utente

panoramica dell'albero di automazione interfaccia utente