Condividi tramite


Tipo di controllo Slider

In questo argomento vengono fornite 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 di selezionare da un set di elementi.

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

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero 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 Panoramica dell'albero di 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à di Automazione interfaccia utente, vedere Recupero di 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 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 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 controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. Gli elementi figlio (pulsanti e pollice) di un controllo dispositivo di scorrimento non devono mai prendere lo stato attivo. Lo stato attivo deve sempre rimanere sul controllo 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 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 english (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 allo sviluppatore dell'applicazione.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo 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.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IRangeValueProvider Dipende da 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 da Un dispositivo di scorrimento deve supportare il pattern di controllo Selection 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 pattern di controllo Value 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.

Automazione interfaccia utente evento Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_RangeValueValuePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo RangeValue , deve supportare questo evento.
UIA_Selection_InvalidatedEventId Se il controllo supporta il modello di controllo Selection , deve supportare questo evento.
UIA_StructureChangedEventId
UIA_ValueValuePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello 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