Condividi tramite

Implementazione del modello di controllo RangeValue dell'automazione della UI

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.

Questo argomento presenta linee guida e convenzioni per l'implementazione di IRangeValueProvider, incluse informazioni su eventi e proprietà. I collegamenti a riferimenti aggiuntivi sono elencati alla fine dell'argomento.

Il RangeValuePattern pattern di controllo viene usato per supportare i controlli che possono essere impostati su un valore all'interno di un intervallo. 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 del valore di intervallo, tenere presenti le linee guida e le convenzioni seguenti:

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

  • I controlli con valori di intervallo ambigui, ad esempio barre di stato o dispositivi di scorrimento, devono avere tali valori normalizzati.

Barra di progresso. Esempio di barra di progresso in cui il valore è di tipo intero e i 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à Nessuno
ValueProperty Proprietà Nessuno
LargeChangeProperty Proprietà Nessuno
SmallChangeProperty Proprietà Nessuno
MaximumProperty Proprietà Nessuno
MinimumProperty Proprietà Nessuno
SetValue Metodi Nessuno

Questo pattern di controllo non ha eventi associati.

Eccezioni

I provider devono sollevare le eccezioni seguenti.

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

Vedere anche

  • Last updated on