Condividi tramite

Tipo di controllo spinner

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Spinner.

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 Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo Spinner. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli spinner in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

Nella tabella seguente viene illustrata una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli di rotazione quando supportano i modelli di controllo RangeValue e Selection e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Modello di controllo RangeValue

Visualizzazione controlli Visualizzazione contenuto
  • Spinner
    • Edit (0 o 1)
    • Button (2)
  • Spinner

 

Selection (pattern di controllo)

Visualizzazione controlli Visualizzazione contenuto
  • Spinner
    • Edit (0 o 1)
    • Button (2)
    • Elemento elenco (0 o più)
  • Spinner
    • ListItem (0 o più)

 

Per assicurarsi che i due pulsanti nel sottoalbero della visualizzazione di controllo possano essere distinti dagli strumenti di test automatizzati, assegnare il valore ScrollAmount_SmallIncrement o ScrollAmount_SmallDecrement alla proprietà AutomationId in base alle esigenze. Per alcune implementazioni, il controllo di modifica associato può essere un peer del controllo spinner.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di spinner. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_AutomationIdPropertyId Vedere le note. Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Il punto selezionabile del controllo casella di selezione fornisce lo stato attivo alla parte modificabile del controllo.
UIA_ControlTypePropertyId Spinner Questo valore è uguale per tutti i framework.
UIA_IsContentElementPropertyId TRUE Il controllo casella di selezione deve essere sempre di tipo contenuto.
UIA_IsControlElementPropertyId TRUE Il controllo spinner deve sempre essere un controllo.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. Un controllo spinner prende raramente lo stato attivo, ma quando lo fa, lo stato attivo deve rimanere sul controllo spinner stesso, non sui pulsanti figlio. L'utente deve essere in grado di eseguire tutte le azioni di scorrimento usando i tasti FRECCIA SU e FRECCIA GIÙ.
UIA_LabeledByPropertyId Vedere le note. I controlli casella di selezione hanno un'etichetta di testo statico.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Spinner . Il valore predefinito è "spinner" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo casella di selezione in genere ricava il proprio nome da un'etichetta di testo statico.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati da tutti i controlli spinner. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IRangeValueProvider Dipende da I controlli spinner che si estendono su un intervallo numerico possono supportare il modello di controllo RangeValue .
ISelectionProvider Dipende da I controlli selezione con un elenco di elementi da selezionare devono supportare il pattern di controllo Selection .
CanSelectMultiple FALSE I controlli casella di selezione sono sempre contenitori a selezione singola.
IValueProvider Dipende da I controlli di selezione che si estendono su un set di opzioni o numeri possono supportare il pattern di controllo Value .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli di selezione. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_RangeValueValuePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo RangeValue , deve supportare questo evento.
UIA_Selection_InvalidatedEventId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Selection , deve supportare questo evento.
UIA_StructureChangedEventId
UIA_ValueValuePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Value , deve supportare questo evento.

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente