Condividi tramite

Implementazione del pattern di controllo Toggle di automazione interfaccia utente

  • Articolo

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono presentate le linee guida e le convenzioni per l'implementazione di IToggleProvider, incluse le informazioni relative a metodi e proprietà. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il pattern di controllo TogglePattern viene usato per supportare i controlli che possono scorrere un insieme di stati e gestire uno stato impostato. Per esempi di controlli che implementano questo pattern di controllo, vedere Control Pattern Mapping for UI Automation Clients.

Linee guida e convenzioni di implementazione

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

  • I controlli che, una volta attivati, non mantengono lo stato, ad esempio pulsanti, pulsanti della barra degli strumenti e collegamenti ipertestuali, devono invece implementare IInvokeProvider .

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

  • TogglePattern non implementa un metodo SetState(newState) a causa di problemi relativi all'impostazione diretta di una casella di controllo a tre stati senza la possibilità di scorrere la relativa sequenza ToggleState appropriata.

  • Il controllo RadioButton non implementa IToggleProviderperché non è in grado di eseguire lo scorrimento tra gli stati validi.

Membri obbligatori per IToggleProvider

Le proprietà e i metodi seguenti sono obbligatori per l'implementazione di IToggleProvider.

Membro obbligatorio Tipo di membro Note
Toggle metodo None
ToggleStateProperty Proprietà None

Questo pattern di controllo non è associato a eventi.

Eccezioni

Questo pattern di controllo non è associato a eccezioni.

Vedi anche