Condividi tramite

Tipo di controllo ScrollBar

  • Articolo

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

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

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 ScrollBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli barra 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 barra 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
  • ScrollBar
    • Pulsante (0, 2 o 4)
    • Thumb (0 o 1)
 Non applicabile. Il controllo barra di scorrimento non contiene 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à di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante 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 pattern di controllo Scroll, supportato nello scorrimento del contenitore.

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 Nan Il controllo barra di scorrimento non dispone di punti selezionabili.
UIA_ControlTypePropertyId scrollbar Questo valore è lo stesso per tutti i framework. Le barre di scorrimento che funzionano come dispositivi di scorrimento devono usare il tipo di controllo Slider.
UIA_IsContentElementPropertyId FALSO 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 VERO Il controllo barra 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à. Un controllo barra di scorrimento raramente prende lo stato attivo, ma quando 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) oppure i tasti PAGINA SU e PAGINA GIÙ.
UIA_LabeledByPropertyId NULLO 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 NULLO Il controllo barra di scorrimento non dispone di elementi di contenuto e non è necessario impostare la proprietà UIA_NamePropertyId.
UIA_OrientationPropertyId Vedere le note. Il controllo barra di scorrimento deve sempre esporre l'orientamento orizzontale o verticale.

 

Modelli di controllo obbligatori

La tabella seguente elenca i pattern di controllo di 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.For more information on control patterns, see UI Automation Control Patterns Overview.

Nota

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

 

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

 

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli barra 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_StructureChangedEventId
UIA_RangeValueValuePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo RangeValue, deve supportare questo evento.

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente