Tipo di controllo MenuBar
Questo argomento fornisce informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo MenuBar.
I controlli barra dei menu sono un esempio di controlli che implementano il MenuBar tipo di controllo. Le barre dei menu consentono agli utenti di attivare comandi e opzioni contenuti in un'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 MenuBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della barra dei menu 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
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo tipico e una visualizzazione contenuto dell'albero di automazione interfaccia utente relativo ai controlli barra dei menu 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 |
|---|---|
|
|
Un controllo barra dei menu viene sempre visualizzato nella visualizzazione controllo, ma non nella visualizzazione contenuto perché in genere non trasmette informazioni significative all'utente finale (a meno che l'applicazione non contenga più barre dei menu).
I client di automazione interfaccia utente possono restare in ascolto dell'evento UIA_MenuModeStartEventId per assicurarsi che vengano notificati in modo coerente quando l'interfaccia utente entra in modalità menu. Quando l'applicazione è in modalità menu, è possibile acquisire tutto l'input della tastiera per la navigazione nel menu, ad esempio digitando "s" potrebbe richiamare il menu Salva anziché digitare il carattere nell'area client dell'applicazione. L'evento UIA_MenuModeStartEventId deve precedere il primo evento UIA_MenuOpenedEventId per garantire la coerenza logica. L'evento UIA_MenuModeEndEventId segue l'ultimo evento UIA_MenuClosedEventId. Se si fa clic su una voce di menu, è possibile attivare immediatamente l'evento UIA_MenuModeStartEventId, seguito da un evento UIA_MenuOpenedEventId.
Un controllo barra dei menu può contenere altri controlli, ad esempio i controlli di modifica e le caselle combinate, all'interno della relativa struttura. Questi controlli aggiuntivi corrispondono agli "altri controlli" elencati in precedenza nelle visualizzazioni controllo e contenuto.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per il tipo di controllo MenuBar. 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_AcceleratorKeyPropertyId | NULLO | Le barre dei menu in genere non hanno tasti di scelta rapida. |
| UIA_AccessKeyPropertyId | "ALT" | La pressione del tasto ALT dovrebbe in genere portare lo stato attivo sulla barra dei menu all'interno dell'applicazione. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il valore esposto da questa proprietà deve includere tutti i controlli contenuti al suo interno. |
| UIA_ControlTypePropertyId | MenuBar | |
| UIA_IsContentElementPropertyId | FALSO | Il controllo barra dei menu non è incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo barra dei menu è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | VERO | I controlli barra dei menu sono attivabili da tastiera perché i controlli che contengono 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 barra dei menu in genere non hanno un'etichetta. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al MenuBar tipo di controllo. Il valore predefinito è "barra dei menu" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il controllo barra dei menu non richiede un nome a meno che un'applicazione non disponga di più barre dei menu. Se in un'applicazione sono presenti più barre dei menu, usare questa proprietà per esporre nomi distinti, ad esempio "Formattazione" o "Struttura". |
| UIA_OrientationPropertyId | Dipende | Questa proprietà espone se il controllo barra dei menu è orizzontale o verticale. |
Modelli di controllo obbligatori
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli barra dei menu. 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 |
|---|---|---|
| IExpandCollapseProvider | Dipende | Se il controllo può essere espanso o compresso, deve implementare il pattern di controllo ExpandCollapse. |
| IDockProvider | Dipende | Se il controllo può essere ancorato a diverse parti dello schermo, deve implementare il pattern di controllo Dock. |
| ITransformProvider | Dipende | Se il controllo può essere ridimensionato, ruotato o spostato, deve implementare il pattern di controllo transform. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli barra dei menu. 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_ExpandCollapseExpandCollapseStatePropertyId evento di modifica delle proprietà. | Se il controllo supporta il ExpandCollapse pattern di controllo, deve supportare questo evento. |
| 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 |
Argomenti correlati