Condividi tramite

Tipo di controllo AppBar

  • Articolo

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

Una barra dell'app è un elemento dell'interfaccia utente che presenta strumenti, comandi e navigazione all'utente. Per le app di Windows Store, le barre delle app per le app possono essere visualizzate premendo Tasto Windows + Z.

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 appBar .

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 controlli AppBar e descrive cosa può essere contenuto in ogni visualizzazione. Button è l'elemento più comune all'interno di un AppBar, ma sono possibili anche altri controlli che richiamano azioni per un'app. Un AppBar può avere anche 0 o più separatori (separatore tipo di controllo), che vengono visualizzati nella visualizzazione controllo come posizionati tra gli altri controlli. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Visualizzazione controlli Visualizzazione contenuto
  • AppBar
    • Pulsante (0 o molti)
    • Altri controlli (0 o molti)
  • Non applicabile
    • Pulsante (0 o molti)
    • Altri controlli (0 o molti)

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli che implementano il tipo di controllo AppBar. 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 valore esposto da questa proprietà deve includere tutti i controlli contenuti al suo interno.
UIA_ControlTypePropertyId AppBar
UIA_IsContentElementPropertyId FALSO Un controllo barra dell'app non è incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Un controllo barra dell'app è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. I controlli all'interno della barra dell'app in genere possono assumere lo stato attivo della tastiera.
UIA_IsOffscreenPropertyId Vedere le note. Il valore di questa proprietà dipende dal fatto che il controllo sia visualizzabile sullo schermo.
UIA_LabeledByPropertyId Nullo I controlli della barra dell'app in genere non hanno un'etichetta.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo AppBar. Il valore predefinito è "barra dell'app" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo della barra dell'app non richiede un nome a meno che un'applicazione non abbia più di una barra dell'app. Se in un'applicazione sono presenti più barre dell'app, usare questa proprietà per esporre nomi distinti, ad esempio "Top" o "Bottom".

 

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli della barra delle app. 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

 

Eventi rilevanti

La tabella seguente elenca gli eventi di automazione interfaccia utente particolarmente rilevanti per i controlli che implementano il tipo di controllo AppBar ma non strettamente richiesto.

Evento di automazione interfaccia utente Note
UIA_MenuClosedEventId Le implementazioni della piattaforma potrebbero generare questo evento quando il controllo della barra dell'app viene chiuso.
UIA_MenuOpenedEventId Le implementazioni della piattaforma potrebbero generare questo evento quando viene aperto il controllo della barra dell'app.
IUIAutomationPropertyChangedEventHandler Gestore eventi con modifica della proprietà.

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente

riferimento

controllo XAML AppBar

oggetto WinJS.UI.AppBar