Tipo di controllo StatusBar
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo StatusBar.
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 in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- osservazioni
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di Automazione interfaccia utente che riguarda i controlli barra di stato e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli della barra di stato. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il rettangolo di delimitazione di una barra di stato deve includere tutti i controlli contenuti al suo interno. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se sono presenti aree all'interno del rettangolo di delimitazione che non sono selezionabili e l'elemento esegue un hit testing specializzato, eseguirne l'override e fornire un punto selezionabile. |
| UIA_ControlTypePropertyId | StatusBar | |
| UIA_IsContentElementPropertyId | VERO | Il controllo barra di stato è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo barra di stato è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Dipende | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_IsOffscreenPropertyId | Dipende | Se un controllo barra di stato non è attualmente visibile, restituirà TRUE per questa proprietà. |
| UIA_LabeledByPropertyId | NULLO | Il controllo barra di stato in genere non dispone di un'etichetta. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo StatusBar. Il valore predefinito è "barra di stato" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | 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". |
| UIA_OrientationPropertyId | Dipende | Valore che indica l'orientamento del controllo: orizzontale o verticale. |
Modelli di controllo obbligatori
Nella tabella seguente sono elencati i modelli di controllo di automazione interfaccia utente necessari per supportare i controlli della barra di stato. 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.
| Pattern di controllo | Appoggiare | Note |
|---|---|---|
| IGridProvider | Opzionale | I controlli barra di stato devono supportare il pattern di controllo griglia di in modo che i singoli pezzi possano essere monitorati e facilmente a cui si fa riferimento per informazioni. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli barra di stato. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietà IsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietà IsOffscreen, deve supportare questo evento. |
| UIA_StructureChangedEventId |
Osservazioni
È consigliabile usare i controlli di modifica come elementi della griglia figlio in una barra di stato. L'uso dei controlli di modifica semplifica l'associazione dello scopo del campo di stato al relativo valore usando il nome dell'elemento e la proprietà value. Poiché i controlli di testo non devono supportare il pattern di controllo valore, non devono essere usati come elementi della griglia figlio.
Argomenti correlati