Condividi tramite

Supporto dell'automazione interfaccia utente per il tipo di controllo StatusBar

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 StatusBar. 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.

Un controllo barra di stato visualizza informazioni su un oggetto visualizzato in una finestra di un'applicazione, il componente dell'oggetto o informazioni contestuali correlate all'operazione dell'oggetto all'interno dell'applicazione.

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 StatusBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della barra di stato, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.

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 stato e descrive cosa può contenere ciascuna 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 stato

- Modifica (0 o più)
- Barra di progresso (0 o molti)
- Immagine (0 o molti)
- Pulsante (0 o molti)		 Barra di stato

- Modifica (0 o più)
- ProgressBar (0 o molti)
- Immagine (0 o molti)
- Pulsante (0 o molti)

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 indicatore di stato. 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. Il rettangolo di delimitazione di una barra di stato deve includere tutti i controlli contenuti al suo interno.
ClickablePointProperty Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
NameProperty Vedere le note. Il controllo barra di stato non richiede un nome a meno che non vengano usati più di uno all'interno di un'applicazione. In questo caso, distinguere ogni barra con nomi come "Stato Internet" o "Stato applicazione".
LabeledByProperty Null Il controllo barra di stato in genere non dispone di un'etichetta.
ControlTypeProperty Barra di stato Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty "barra di stato" Stringa localizzata corrispondente al tipo di controllo StatusBar.
IsContentElementProperty Vero Il controllo barra di stato contiene sempre contenuto.
IsControlElementProperty Vero Il controllo della barra di stato è sempre un controllo.
IsOffscreenProperty Dipende da Un controllo barra di stato restituirà True per questa proprietà se non è attualmente visibile sullo schermo.
OrientationProperty Dipende da Valore dell'orientamento del controllo: orizzontale o verticale.
IsKeyboardFocusableProperty Falso Non applicabile
AcceleratorKeyProperty Null Le barre di stato non dispongono di tasti di scelta rapida.

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 stato. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Assistenza Note
IGridProvider Opzionale I controlli della barra di stato devono supportare il pattern di controllo Grid, così che i singoli componenti possano essere monitorati e facilmente referenziati per ottenere informazioni.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli barra di stato. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di automazione interfaccia utente Assistenza 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
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche