Condividi tramite

Tipo di controllo spinner

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo spinner.

I controlli di selezione vengono usati per selezionare da un dominio di elementi o da un intervallo di numeri.

Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo spinner. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di selezione in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.

Questo argomento contiene le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguardano i controlli di selezione quando supportano i RangeValue e i pattern di controllo Selection e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

pattern di controllo RangeValue

Visualizzazione controlli Visualizzazione contenuto
  • Filatore
    • Modifica (0 o 1)
    • Pulsante (2)
  • Filatore

 

pattern di controllo Selection

Visualizzazione controlli Visualizzazione contenuto
  • Filatore
    • Modifica (0 o 1)
    • Pulsante (2)
    • Elemento elenco (0 o più)
  • Filatore
    • ListItem (0 o più)

 

Per assicurarsi che i due pulsanti nel sottoalbero della visualizzazione controlli 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 di selezione.

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di selezione. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.

Ui Automation, proprietà 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 di automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Il punto selezionabile del controllo di selezione assegna lo stato attivo alla parte di modifica del controllo.
UIA_ControlTypePropertyId spinner Questo valore è lo stesso per tutti i framework.
UIA_IsContentElementPropertyId VERO Il controllo di selezione deve essere sempre contenuto.
UIA_IsControlElementPropertyId VERO Il controllo di selezione deve essere sempre un controllo .
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. Un controllo di selezione prende raramente lo stato attivo, ma quando lo fa, lo stato attivo deve rimanere sul controllo di selezione 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 di selezione hanno un'etichetta di testo statica.
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 di selezione ottiene in genere il nome da un'etichetta di testo statica.

 

Modelli di controllo obbligatori

La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli di selezione. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.

Pattern di controllo/pattern, proprietà Supporto/valore Note
IRangeValueProvider Dipende I controlli di selezione che si estendono su un intervallo numerico possono supportare il pattern di controllo RangeValue.
ISelectionProvider Dipende I controlli di selezione che dispongono di un elenco di elementi da selezionare devono supportare il pattern di controllo Selezione.
CanSelectMultiple FALSO I controlli di selezione sono sempre contenitori a selezione singola.
IValueProvider Dipende I controlli di selezione che si estendono su un set di opzioni o numeri descrete possono supportare il pattern di controllo valore.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli di selezione. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

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

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente