Implementazione del pattern di controllo RangeValue 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 IRangeValueProvider, incluse le informazioni relative a eventi e proprietà. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il pattern di controllo RangeValuePattern viene usato per supportare i controlli che possono impostare un valore in un intervallo. 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 RangeValue, tenere presenti le linee guida e le convenzioni seguenti:

  • I controlli consentono la ricalibrazione delle relative proprietà supportate in base alle preferenze utente o alle impostazioni locali. Un esempio di questo è un controllo termometro che può essere impostato per visualizzare la temperatura in gradi Fahrenheit o Celsius.

  • I controlli che dispongono di valori di intervallo ambigui, ad esempio le barre di avanzamento o i dispositivi di scorrimento, devono avere questi valori normalizzati.

Progress bar. Esempio di un indicatore di stato in cui valore è di tipo Integer e i relativi valori di proprietà minimo e massimo sono normalizzati rispettivamente a 0 e 100

Membri obbligatori per IRangeValueProvider

Membro obbligatorio Tipo di membro Note
IsReadOnlyProperty Proprietà None
ValueProperty Proprietà None
LargeChangeProperty Proprietà None
SmallChangeProperty Proprietà None
MaximumProperty Proprietà None
MinimumProperty Proprietà None
SetValue Metodi None

Questo pattern di controllo non è associato a eventi.

Eccezioni

I provider devono generare le eccezioni seguenti.

Tipo di eccezione Condizione
ArgumentOutOfRangeException SetValue viene chiamato con un valore che è maggiore di MaximumProperty o minore di MinimumProperty.

Vedi anche