Supporto per automazione interfaccia utente del tipo di controllo Spinner
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Spinner. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
I controlli casella di selezione vengono usati per effettuare selezioni da un dominio di elementi o un intervallo di numeri.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo Spinner. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli spinner, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli spinner quando supportano i criteri di controllo Range Value, Value e Selection e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
Pattern di controllo RangeValue o Value
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Casella di selezione - Modifica (0 o 1) - Pulsante (2) |
Casella di selezione |
Selection (pattern di controllo)
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Casella di selezione - Modifica (0 o 1) - Pulsante (2) - Elemento elenco (0 o più) |
Casella di selezione - ListItem (0 o più) |
Per garantire che i due pulsanti nel sottoalbero della visualizzazione controlli possano essere rilevati dagli strumenti di test automatici, assegnare SmallIncrement o SmallDecrement AutomationId come appropriato. Per alcune implementazioni il controllo di modifica associato può essere un elemento di pari livello del controllo Spinner.
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli spinner. Per maggiori informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Il punto selezionabile del controllo casella di selezione fornisce lo stato attivo alla parte modificabile del controllo. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo casella di selezione in genere ricava il proprio nome da un'etichetta di testo statico. |
| LabeledByProperty | Vedere le note. | I controlli casella di selezione hanno un'etichetta di testo statico. |
| ControlTypeProperty | Casella di selezione | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "spinner" | Stringa localizzata corrispondente al tipo di controllo Spinner. |
| IsContentElementProperty | Vero | Il controllo casella di selezione deve essere sempre di tipo contenuto. |
| IsControlElementProperty | Vero | Il controllo casella di selezione deve essere sempre un contenuto. |
Pattern di controllo e proprietà obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli spinner. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| ISelectionProvider | Dipende da | I controlli casella di selezione che dispongono di un elenco di elementi da selezionare devono supportare questo pattern. |
| CanSelectMultiple | Falso | I controlli casella di selezione sono sempre contenitori a selezione singola. |
| IRangeValueProvider | Dipende da | I controlli casella di selezione che occupano un intervallo numerico possono supportare questo pattern. |
| IValueProvider | Dipende da | I controlli casella di selezione che si estendono su un set discreto di opzioni o numeri possono supportare questo pattern. |
Eventi di automazione interfaccia utente obbligatori
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli spinner. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| InvalidatedEvent | Dipende da | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |