Tipo di controllo ScrollBar

  • Articolo

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

I controlli barra di scorrimento consentono agli utenti di scorrere il contenuto all'interno di una finestra o un contenitore di elementi. Il controllo è costituito da un set di pulsanti e da un controllo personale.

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 ScrollBar. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli barra 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 barra 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
  • ScrollBar
    • Pulsante (0, 2 o 4)
    • Pollice (0 o 1)
 Non applicabile. Il controllo barra di scorrimento non ha contenuto.

 

Il controllo barra di scorrimento può avere zero a cinque elementi figlio. Poiché il sottoalbero ha più di un controllo pulsante, l'elemento deve impostare un valore di UIA_AutomationIdPropertyId specifico su ogni elemento per renderli individuabili per gli strumenti di test automatizzati.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per i controlli barra di scorrimento. Si noti che un controllo barra di scorrimento non ha mai contenuto; la relativa funzionalità viene esposta tramite il modello di controllo Scroll , supportato nel contenitore in corso 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 NaN Il controllo barra di scorrimento non dispone di punti selezionabili.
UIA_ControlTypePropertyId ScrollBar Questo valore è uguale per tutti i framework. Le barre di scorrimento che funzionano come dispositivi di scorrimento devono usare il tipo di controllo Slider .
UIA_IsContentElementPropertyId FALSE Il controllo barra di scorrimento non è mai un elemento di contenuto. Se la barra di scorrimento è un controllo autonomo, deve soddisfare il tipo di controllo Slider e restituire UIA_SliderControlTypeId per la proprietà IUIAutomationElement::CurrentControlType (o CachedControlType).
UIA_IsControlElementPropertyId TRUE Il controllo barra 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à. Un controllo barra di scorrimento prende raramente lo stato attivo, ma quando lo fa, lo stato attivo deve rimanere sul controllo barra di scorrimento stesso, non sui pulsanti figlio o sul pollice. L'utente deve essere in grado di eseguire tutte le azioni di scorrimento usando i tasti FRECCIA SU e FRECCIA GIÙ (o FRECCIA DESTRA e FRECCIA SINISTRA) o i tasti PAGE UP e PAGE DOWN.
UIA_LabeledByPropertyId NULL Le barre di scorrimento non hanno etichette.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo ScrollBar . Il valore predefinito è "barra di scorrimento" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId NULL Il controllo barra di scorrimento non dispone di elementi di contenuto e la proprietà UIA_NamePropertyId non è necessaria per essere impostata.
UIA_OrientationPropertyId Vedere le note. Il controllo barra di scorrimento deve sempre esporre il relativo orientamento orizzontale o verticale.

 

Modelli di controllo obbligatori

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

Nota

Quando una barra di scorrimento viene usata come controllo solo per la manipolazione del mouse, non supporta i modelli di controllo. Se viene usato come controllo dispositivo di scorrimento all'interno di un'applicazione, deve essere assegnato il tipo di controllo Slider .

 

Pattern di controllo Supporto Note
IRangeValueProvider Dipende da Il modello di controllo RangeValue deve essere supportato solo se il modello di controllo Scroll non è supportato nel contenitore con la barra di scorrimento.
IScrollProvider Mai Il modello di controllo Scroll non è mai supportato direttamente sulla barra di scorrimento.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente che i controlli barra di scorrimento sono necessari per supportare. 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_StructureChangedEventId
UIA_RangeValueValuePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo RangeValue , deve supportare questo evento.

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente