Condividi tramite

Tipo di controllo Dispositivo di scorrimento

  • Articolo

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

Un controllo dispositivo di scorrimento è un controllo composito con pulsanti che consentono a un utente di impostare un intervallo numerico o di selezionare da un set di elementi.

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 Slider. I requisiti di automazione interfaccia utente si applicano a tutti i controlli dispositivo di scorrimento 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 riguarda i controlli dispositivo di scorrimento e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Visualizzazione controlli Visualizzazione contenuto
  • Cursore
    • Pulsante (2 o 4)
    • Thumb (1)
    • Elemento elenco (0 o più)
  • Cursore
    • Elemento elenco (0 o più)

 

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli dispositivo di scorrimento. 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. La maggior parte dei controlli dispositivo di scorrimento deve restituire l'errore UIA_E_NOCLICKABLEPOINT perché l'intero rettangolo di delimitazione del controllo dispositivo di scorrimento è occupato dai controlli figlio.
UIA_ControlTypePropertyId Slider Questo valore è lo stesso per tutti i framework.
UIA_IsContentElementPropertyId VERO Il controllo dispositivo di scorrimento è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo dispositivo di scorrimento è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. Gli elementi figlio (pulsanti e pollice) di un controllo dispositivo di scorrimento non devono mai portare lo stato attivo. Lo stato attivo deve rimanere sempre sul dispositivo di scorrimento stesso.
UIA_LabeledByPropertyId Vedere le note. Se al controllo è associata un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo. Se il controllo di testo è un sottocomponente di un altro controllo, non avrà un LabeledBy proprietà impostata.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo slider. Il valore predefinito è "slider" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il nome del controllo dispositivo di scorrimento viene in genere generato da un'etichetta di testo statica. Se non è presente un'etichetta di testo statico, è necessario assegnare un valore della proprietà per Nome dallo sviluppatore dell'applicazione.

 

Modelli di controllo obbligatori

La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli dispositivo di scorrimento. 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 Un dispositivo di scorrimento deve supportare il pattern di controllo RangeValue se il contenuto può essere impostato su un valore all'interno di un intervallo numerico.
ISelectionProvider Dipende Un dispositivo di scorrimento deve supportare il pattern di controllo Selezione se il contenuto rappresenta un valore tra un set discreto di opzioni. Quando il pattern di controllo Selection è supportato, la selezione corrispondente deve essere esposta come uno o più elementi dell'elenco figlio del dispositivo di scorrimento.
IValueProvider Dipende Un dispositivo di scorrimento deve supportare il pattern di controllo valore se il contenuto rappresenta un valore tra un set discreto di opzioni.

 

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli dispositivo di scorrimento. 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 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