Tipo di controllo AppBar

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente 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, è possibile visualizzare le barre delle app premendo tasto Windows + Z.

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo AppBar.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente relativo ai controlli AppBar e descrive cosa può essere contenuto in ogni visualizzazione. Il pulsante è l'elemento più comune all'interno di un controllo AppBar , ma anche altri controlli che richiamano azioni per un'app sono possibili. Un controllo AppBar può avere anche 0 o più separatori (tipo di controllo Separatore), che vengono visualizzati nella visualizzazione controlli come posizionati tra gli altri controlli. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • AppBar
    • Button (0 o più)
    • Altri controlli (0 o molti)
  • Non applicabile
    • Button (0 o più)
    • Altri controlli (0 o molti)

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà 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 di 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 valore esposto da questa proprietà deve includere tutti i controlli contenuti.
UIA_ControlTypePropertyId AppBar
UIA_IsContentElementPropertyId FALSE Un controllo della barra dell'app non è incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Un controllo della barra dell'app è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note Se il controllo può ricevere lo stato attivo, 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 o meno sullo schermo.
UIA_LabeledByPropertyId Null I controlli della barra delle 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

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli della barra delle app. 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

 

Eventi rilevanti

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente particolarmente rilevanti per i controlli che implementano il tipo di controllo AppBar, ma non strettamente necessari.

evento 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 di modifica della proprietà.

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente

Riferimento

Controllo XAML AppBar

Oggetto WinJS.UI.AppBar