Condividi tramite


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

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
  • StatusBar
    • Modifica (0 o più)
    • ProgressBar (0 o molti)
    • Immagine (0 o molti)
    • Pulsante (0 o molti)
  • StatusBar
    • Modifica (0 o più)
    • ProgressBar (0 o molti)
    • Immagine (0 o molti)
    • Pulsante (0 o molti)

 

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.

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente