Tipo di controllo StatusBar

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo StatusBar.

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 Automazione interfaccia utente, le proprietà, i modelli 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 dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli barra di stato e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • StatusBar
    • Edit (0 o più)
    • ProgressBar (0 o più)
    • Image (0 o più)
    • Button (0 o più)
  • StatusBar
    • Edit (0 o più)
    • ProgressBar (0 o più)
    • Image (0 o più)
    • Button (0 o più)

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per i controlli della barra di stato. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente 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 Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo di delimitazione di una barra di stato deve includere tutti i controlli in esso contenuti.
UIA_ClickablePointPropertyId Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se sono presenti aree all'interno del rettangolo di selezione che non sono selezionabili e l'elemento esegue hit test specializzati, eseguire l'override di questo e fornire un punto clickable.
UIA_ControlTypePropertyId StatusBar
UIA_IsContentElementPropertyId TRUE Il controllo barra di stato è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo barra di stato è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Dipende da Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_IsOffscreenPropertyId Dipende da Se un controllo barra di stato non è attualmente visibile, restituirà TRUE per questa proprietà.
UIA_LabeledByPropertyId NULL Il controllo barra di stato in genere non ha 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 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 come "Stato Internet" o "Stato applicazione".
UIA_OrientationPropertyId Dipende da Valore che indica l'orientamento del controllo: orizzontale o verticale.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati per i controlli barra di stato. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto Note
IGridProvider Facoltativo I controlli barra di stato devono supportare il modello di controllo Griglia 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 Automazione interfaccia utente che i controlli della barra di stato sono necessari per supportare. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_StructureChangedEventId

 

Commenti

È 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 Value , non devono essere usati come elementi della griglia figlio.

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente