Tipo di controllo dispositivo di scorrimento

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

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

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 Slider. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli di scorrimento 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

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli del dispositivo di scorrimento e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Slider
    • Button (2 o 4)
    • Pollice (1)
    • Elemento elenco (0 o più)
  • Slider
    • Elemento elenco (0 o più)

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli dispositivo di scorrimento. 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. La maggior parte dei controlli del dispositivo di scorrimento deve restituire l'errore UIA_E_NOCLICKABLEPOINT perché l'intero rettangolo di selezione del controllo dispositivo di scorrimento è occupato dai controlli figlio.
UIA_ControlTypePropertyId Dispositivo di scorrimento Questo valore è uguale per tutti i framework.
UIA_IsContentElementPropertyId true Il controllo dispositivo di scorrimento è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId true Il controllo dispositivo di scorrimento è sempre incluso nella visualizzazione del controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. I bambini (pulsanti e pollice) di un controllo dispositivo di scorrimento non devono mai prendere lo stato attivo. Lo stato attivo deve rimanere sempre sul controllo del dispositivo di scorrimento stesso.
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statica associata al controllo, questa proprietà deve esporre un riferimento a tale controllo. Se il controllo di testo è un sottocomponente di un altro controllo, non avrà un set di proprietà LabeledBy .
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 statica, è necessario assegnare un valore di proprietà per Name dallo sviluppatore dell'applicazione.

 

Modelli di controllo obbligatori

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

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli dispositivo di scorrimento. 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 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