Supporto per automazione interfaccia utente del tipo di controllo ScrollBar

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo ScrollBar. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e i pattern di controllo.

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

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo ScrollBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli elenco, Windows Presentation Foundation (WPF), Win32 o Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

  • Struttura ad albero di automazione interfaccia utente obbligatoria
  • Proprietà di automazione interfaccia utente obbligatorie
  • Pattern di controllo di automazione interfaccia utente obbligatori
  • Eventi di automazione interfaccia utente obbligatori
  • Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli barra di scorrimento e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli

Visualizzazione contenuto

  • ScrollBar

    • Button (2 o 4)

    • Thumb (0 o1)

Il controllo della barra di scorrimento non contiene contenuto.

Il controllo barra di scorrimento ha sempre da tre a cinque figli. Poiché la sottostruttura contiene più controlli pulsante, è necessario impostare un valore AutomationIdProperty specifico su ogni elemento per renderlo individuabile agli strumenti di automazione dei test.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella riportata di seguito sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli barra di scorrimento. Si noti che un controllo barra di scorrimento non ha mai contenuto e che la relativa funzionalità viene esposta tramite il pattern di controllo Scroll, supportato sul contenitore che scorre.

Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente

Valore

Note

AutomationIdProperty()

Vedere le note.

Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.

BoundingRectangleProperty

Vedere le note.

Il rettangolo più esterno che contiene l'intero controllo.

IsKeyboardFocusableProperty

Vedere le note.

Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.

NameProperty

Null

Il controllo barra di scorrimento non ha elementi contenuto elementi e non occorre impostare NameProperty.

ClickablePointProperty

Non un numero.

Il controllo barra di scorrimento non ha punti selezionabili.

LabeledByProperty

Null

Le barre di scorrimento non hanno etichette.

ControlTypeProperty

ScrollBar

Questo valore è identico per tutti i framework. Le barre di scorrimento che funzionano come dispositivi di scorrimento devono utilizzare il tipo di controllo Slider.

LocalizedControlTypeProperty

"barra di scorrimento"

Stringa localizzata che corrisponde al tipo di controllo Button.

IsContentElementProperty

False

Il controllo barra di scorrimento non è mai un elemento contenuto. Se la barra di scorrimento è un controllo autonomo, è necessario che soddisfi il tipo di controllo Slider e restituisca ControlType.Slider per la proprietà ControlType.

IsControlElementProperty

True

La barra di scorrimento deve essere sempre un controllo.

OrientationProperty

True

Il controllo barra di scorrimento deve esporre sempre l'orientamento orizzontale o verticale.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati dai controlli barra di scorrimento. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente. Si noti che una barra di scorrimento utilizzata solo come controllo per la manipolazione del mouse non supporta pattern di controllo. Se utilizzata come dispositivo di scorrimento in un'applicazione, è necessario assegnare a essa il tipo di controllo Slider.

Pattern di controllo/Proprietà pattern

Supporto/Valore

Note

IScrollProvider

Mai

Il pattern di controllo Scroll non è mai supportato direttamente sulla barra di scorrimento.

IRangeValueProvider

A seconda dei casi

Il supporto di questa funzionalità è necessario solo se il pattern di controllo Scroll non è supportato sul contenitore della barra di scorrimento.

Eventi di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli barra di scorrimento. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto/Valore

Note

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata HorizontallyScrollableProperty.

Mai

Nessuno

Evento di proprietà modificata HorizontalScrollPercentProperty.

Mai

Nessuno

Evento di proprietà modificata HorizontalViewSizeProperty.

Mai

Nessuno

Evento di proprietà modificata VerticalScrollPercentProperty.

Mai

Nessuno

Evento di proprietà modificata VerticallyScrollableProperty.

Mai

Nessuno

Evento di proprietà modificata VerticalViewSizeProperty.

Mai

Nessuno

Evento di proprietà modificata ValueProperty.

A seconda dei casi

Nessuno

AutomationFocusChangedEvent

Obbligatorio

Nessuno

StructureChangedEvent

Obbligatorio

Nessuno

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

ScrollBar