Condividi tramite

Supporto dell'automazione dell'interfaccia utente per il tipo di controllo della barra di scorrimento

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo ScrollBar. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 di un contenitore di elementi. Il controllo è costituito da un set di pulsanti e un joystick.

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo ScrollBar. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli elenco, sia che si tratti di Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la vista dei controlli e la vista del contenuto dell'albero di automazione dell'interfaccia utente relativa ai controlli della barra di scorrimento e descrive cosa può essere contenuto in ogni vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.

Vista di controllo Visualizzazione contenuto
barra di scorrimento

- Pulsante (2 o 4)
- Pollice (0 o 1)		 Non applicabile. Il controllo barra di scorrimento non contiene contenuto.

Il controllo della barra di scorrimento ha sempre da tre a cinque elementi figli. Poiché il sottoalbero ha più di un controllo pulsante, è necessario impostare un valore specifico AutomationIdProperty su ogni elemento per renderli individuabili per gli strumenti di automazione dei test.

Proprietà di automazione interfaccia utente necessarie

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 Proprietà di automazione interfaccia utente per i client.

Ui Automation, proprietà Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione.
BoundingRectangleProperty Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
NameProperty Null Il controllo barra di scorrimento non dispone di elementi di contenuto e NameProperty non è necessario impostare .
ClickablePointProperty Non un numero. Il controllo barra di scorrimento non dispone di punti selezionabili.
LabeledByProperty Null Le barre di scorrimento non hanno etichette.
ControlTypeProperty barra di scorrimento Questo valore è lo stesso per tutti i framework. Le barre di scorrimento che funzionano come slider devono usare il tipo di controllo Slider.
LocalizedControlTypeProperty "barra di scorrimento" Stringa localizzata che corrisponde al tipo di controllo Button.
IsContentElementProperty 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 ControlType.Slider per la ControlType proprietà.
IsControlElementProperty Vero La barra di scorrimento deve sempre essere un controllo.
OrientationProperty Vero Il controllo barra di scorrimento deve sempre esporre l'orientamento orizzontale o verticale.

Modelli di controllo di automazione interfaccia utente necessari

La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai 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. Si noti che 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 tipo di controllo Slider.

Pattern di controllo Assistenza Note
IScrollProvider Mai Il modello di controllo Scorrimento non viene mai supportato direttamente sulla barra di scorrimento.
IRangeValueProvider Dipende da Questa funzionalità è necessaria per essere supportata solo se il pattern di controllo Scroll non è supportato nel contenitore con la barra di scorrimento.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli barra di scorrimento. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Supporto/valore Note
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà HorizontallyScrollableProperty. Mai Nessuno
Evento di cambiamento della proprietà HorizontalScrollPercentProperty. Mai Nessuno
Evento di cambiamento della proprietà HorizontalViewSizeProperty. Mai Nessuno
Evento di cambiamento della proprietà VerticalScrollPercentProperty. Mai Nessuno
Evento di cambiamento della proprietà VerticallyScrollableProperty. Mai Nessuno
Evento di cambiamento della proprietà VerticalViewSizeProperty. Mai Nessuno
Evento di cambiamento della proprietà ValueProperty. Dipende da Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche