Supporto per automazione interfaccia utente del tipo di controllo ScrollBar
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per 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 per poter 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 criteri di controllo.
I controlli barra di scorrimento consentono agli utenti di scorrere il contenuto all'interno di una finestra o un contenitore di elementi. Il controllo è composto da un insieme di pulsanti e un controllo Thumb.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri 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, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli barra di scorrimento e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| ScrollBar - Pulsante (2 o 4) - Thumb (0 o 1) |
Non applicabile. Il controllo barra di scorrimento non include contenuto. |
Il controllo barra di scorrimento contiene sempre da tre a cinque elementi figlio. Poiché il sottoalbero contiene più di un controllo pulsante, è necessario impostare un valore specifico per AutomationIdProperty per ogni elemento in modo da renderlo individuabile per gli strumenti di automazione dei test.
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca 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 include mai contenuto. La relativa funzionalità viene esposta tramite il pattern di controllo Scroll, che è supportato nel contenitore sottoposto a scorrimento.
Per altre 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 in tutti i controlli in 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 include elementi di contenuto e pertanto non è necessario impostare NameProperty . |
| ClickablePointProperty | Non un numero. | Il controllo barra di scorrimento non dispone di punti selezionabili. |
| LabeledByProperty | Null |
Le barre di scorrimento non hanno etichette. |
| ControlTypeProperty | ScrollBar | Questo valore è uguale per tutti i framework. Le barre di scorrimento con funzione di dispositivo di scorrimento devono usare il tipo di controllo Slider. |
| LocalizedControlTypeProperty | "scroll bar" | Stringa localizzata corrispondente 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 essere conforme al tipo di controllo Slider e restituire ControlType.Slider per la proprietà ControlType . |
| IsControlElementProperty | Vero | La barra di scorrimento deve sempre essere un controllo. |
| OrientationProperty | Vero | Il controllo barra di scorrimento deve sempre esporre il relativo orientamento orizzontale o verticale. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i modelli di controllo di Automazione interfaccia utente che devono essere supportati dai controlli barra di scorrimento. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview. Si noti che quando una barra di scorrimento viene usata come controllo solo per la manipolazione del mouse, non supporta pattern di controllo. Se viene usata come controllo dispositivo di scorrimento all'interno di un'applicazione, è necessario assegnare il tipo di controllo Slider.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IScrollProvider | Mai | Il pattern di controllo Scroll non è mai supportato direttamente nella barra di scorrimento. |
| IRangeValueProvider | Dipende da | Il supporto di questa funzionalità è obbligatorio solo se il pattern di controllo Scroll non è supportato nel contenitore che include la barra di scorrimento. |
Eventi di automazione interfaccia utente obbligatori
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 UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto/valore | Note |
|---|---|---|
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Mai | None |
| Evento di modifica della proprietàHorizontalScrollPercentProperty . | Mai | None |
| Evento di modifica della proprietàHorizontalViewSizeProperty . | Mai | None |
| Evento di modifica della proprietàVerticalScrollPercentProperty . | Mai | None |
| Evento di modifica della proprietàVerticallyScrollableProperty . | Mai | None |
| Evento di modifica della proprietàVerticalViewSizeProperty . | Mai | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |