Supporto per automazione interfaccia utente del tipo di controllo StatusBar
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 StatusBar. 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.
In un controllo barra di stato sono in genere presenti informazioni su un oggetto visualizzato in una finestra di un'applicazione, i componenti dell'oggetto o informazioni contestuali collegate alle operazioni di tale oggetto all'interno dell'applicazione.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo StatusBar. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli barra di stato, 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 stato 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 |
|---|---|
| StatusBar - Modifica (0 o più) - Barra di avanzamento (0 o più) - Immagine (0 o più) - Pulsante (0 o più) |
StatusBar - Modifica (0 o più) - ProgressBar (0 o più) - Immagine (0 o più) - Pulsante (0 o più) |
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 avanzamento. Per maggiori 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 di delimitazione di una barra di stato deve includere tutti i controlli in esso contenuti. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo barra di stato non necessita di un nome a meno che non vengano usati più controlli all'interno di un'applicazione. In questo caso distinguere ogni barra con nomi quali, ad esempio, "Stato Internet" o "Stato applicazione". |
| LabeledByProperty | Null |
Il controllo barra di stato in genere non dispone di un'etichetta. |
| ControlTypeProperty | StatusBar | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "status bar" | Stringa localizzata corrispondente al tipo di controllo StatusBar. |
| IsContentElementProperty | Vero | Il controllo barra di stato include sempre contenuto. |
| IsControlElementProperty | Vero | Il controllo 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. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli barra di stato. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IGridProvider | Facoltativo | I controlli barra di stato devono supportare il pattern di controllo Grid in modo che i singoli elementi possano essere monitorati e consultati facilmente per ottenere le informazioni pertinenti. |
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 stato. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | 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 |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |