Condividi tramite


Implementazione dell'automazione dell'interfaccia utente nel pattern di controllo Attiva/Disattiva

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono illustrate le linee guida e le convenzioni per l'implementazione IToggleProviderdi , incluse informazioni sui metodi e sulle proprietà. I collegamenti a riferimenti aggiuntivi sono elencati alla fine dell'argomento.

Il TogglePattern 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 Mapping dei criteri di controllo per i client di automazione interfaccia utente.

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 invece.

  • Un controllo deve scorrere attraverso il ToggleState nell'ordine seguente: On, Off e, se supportato, Indeterminate.

  • TogglePattern non offre un metodo SetState(newState) a causa di problemi legati alla configurazione diretta di una CheckBox tri-state senza passare attraverso la sequenza ToggleState appropriata.

  • Il controllo RadioButton non implementa IToggleProvider, perché non è in grado di eseguire il ciclo attraverso gli stati validi.

Membri obbligatori per IToggleProvider

Per l'implementazione IToggleProviderdi sono necessari i metodi e le proprietà seguenti.

Membro obbligatorio Tipo di membro Note
Toggle Metodo Nessuno
ToggleStateProperty Proprietà Nessuno

Questo pattern di controllo non ha eventi associati.

Eccezioni

Questo pattern di controllo non presenta eccezioni associate.

Vedere anche