Supporto per automazione interfaccia utente del tipo di controllo StatusBar

Nota
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese).

In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo StatusBar. In UI Automation 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 UI Automation, i valori delle proprietà di UI Automation e i pattern di controllo.

Un controllo barra di stato fornisce informazioni su un oggetto da visualizzare nella finestra di un'applicazione e sul componente di tale oggetto oppure fornisce informazioni contestuali che fanno riferimento all'attività di tale oggetto all'interno di un'applicazione.

Nelle sezioni riportate di seguito vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di UI Automation necessari per il tipo di controllo StatusBar. I requisiti di UI Automation si applicano a tutti i controlli barra di stato, Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Nel presente argomento sono contenute le seguenti sezioni.

• Struttura ad albero di automazione interfaccia utente obbligatoria
• Proprietà di automazione interfaccia utente richieste
• 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 UI Automation relativamente ai controlli barra di stato e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di UI Automation, vedere Cenni preliminari sulla struttura ad albero di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
StatusBar Edit (0 o più) Progress Bar (0 o molti) Image (0 o molte) Button (0 o molti)	StatusBar Edit (0 o più) ProgressBar (0 o molti) Image (0 o molte) Button (0 o molti)

Proprietà di automazione interfaccia utente richieste

Nella tabella riportata di seguito sono elencate le proprietà di UI Automation il cui valore o la cui definizione è particolarmente rilevante per i controlli indicatore di stato. Per ulteriori informazioni sulle proprietà dell'oggetto UI Automation, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di UI Automation	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 di delimitazione di una barra di stato deve includere tutti i controlli contenuti all'interno di esso.
ClickablePointProperty	Vedere le note.	Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire 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 ne venga utilizzato più di uno all'interno di un'applicazione. In questo caso, distinguere ogni barra con nomi quali "Stato Internet" o "Stato applicazione".
LabeledByProperty	Null	Il controllo barra di stato di solito non ha un'etichetta.
ControlTypeProperty	StatusBar	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"barra di stato"	Stringa localizzata che corrisponde al tipo di controllo StatusBar.
IsContentElementProperty	True	Il controllo barra di stato contiene sempre contenuto.
IsControlElementProperty	True	Il controllo barra di stato è sempre un controllo.
IsOffscreenProperty	A seconda dei casi	Un controllo barra di stato restituirà True per questa proprietà se non è attualmente visibile sullo schermo.
OrientationProperty	A seconda dei casi	Il valore dell'orientamento del controllo: orizzontale o verticale.
IsKeyboardFocusableProperty	False	Non applicabile
AcceleratorKeyProperty	Null	Le barre di stato non hanno tasti di scelta rapida.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di UI Automation che devono essere supportati dai controlli barra di stato. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo	Supporto	Note
IGridProvider	Facoltativo	I controlli barra di stato devono supportare il pattern di controllo Grid in modo che sia possibile controllare agevolmente e fare riferimento a parti singole per ottenere informazioni.

Eventi di automazione interfaccia utente obbligatori

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

Evento UI Automation	Supporto	Note
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuno
AutomationFocusChangedEvent	Obbligatorio	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno

Vedere anche

Riferimenti

StatusBar

Concetti

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

Cenni preliminari su automazione interfaccia utente