Condividi tramite


Supporto di automazione interfaccia utente per il tipo di controllo MenuBar

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo MenuBar. In UI Automation, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di UI Automation, i valori delle proprietà di UI Automation e i criteri di controllo.

I controlli barra dei menu sono un esempio di controlli che implementano il tipo di controllo MenuBar. Le barre dei menu consentono agli utenti di attivare comandi e opzioni contenuti in un'applicazione.

Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di UI Automation necessari per il tipo di controllo MenuBar. I requisiti di UI Automation si applicano a tutti i controlli elenco, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.

Struttura ad albero di automazione interfaccia utente obbligatoria

La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di UI Automation che riguarda i controlli barra menu e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.

Visualizzazione controlli Visualizzazione contenuto
MenuBar

- MenuItem (1 o più)
- Altri controlli (0 o molti)
MenuBar

- MenuItem (1 o più)
- Altri controlli (0 o molti)

I controlli barra dei menu possono contenere altri controlli, ad esempio controlli di modifica e caselle combinate, nella struttura. Questi controlli aggiuntivi corrispondono agli "altri controlli" elencati sopra nelle visualizzazioni controlli e contenuto.

Proprietà di automazione interfaccia utente obbligatorie

La seguente tabella elenca le proprietà di UI Automation il cui valore o definizione è particolarmente rilevante per i controlli barra menu. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation per i client.

Proprietà di automazione interfaccia utente Valore Note
BoundingRectangleProperty Vedere le note. Il valore esposto da questa proprietà deve includere tutti i controlli contenuti.
NameProperty Vedere le note. Il controllo barra dei menu non necessita di un nome a meno che un'applicazione non abbia più di una barra dei menu. Se in un'applicazione sono presenti più barre dei menu, questa proprietà deve essere usata per esporre i nomi distinti, ad esempio "Formatting" o "Outlining".
LabeledByProperty Null I controlli barra dei menu non includono mai un'etichetta.
ControlTypeProperty MenuBar Questo valore è uguale per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty "menu bar" Stringa localizzata corrispondente al tipo di controllo MenuBar.
IsContentElementProperty Vero Il controllo barra menu è sempre incluso nella vista contenuto dell'albero di UI Automation.
IsControlElementProperty Vero Il controllo barra menu è sempre incluso nella vista controllo dell'albero di UI Automation.
IsOffscreenProperty Vedere le note. Il valore di questa proprietà dipende dal fatto che il controllo sia visualizzabile o meno sullo schermo.
OrientationProperty Dipende da Questa proprietà espone l'orientamento orizzontale o verticale del controllo barra dei menu.
IsKeyboardFocusableProperty Vero I controlli barra dei menu hanno lo stato attivabile perché i controlli che contengono possono prendere lo stato attivo.
HelpTextProperty Vedere le note. Per un controllo barra dei menu non esistono scenari in cui è necessario il testo della Guida.
AcceleratorKeyProperty Null Le barre dei menu non hanno mai tasti di scelta rapida.
AccessKeyProperty "ALT" Premendo ALT, la barra dei menu nell'applicazione deve sempre prendere lo stato attivo.

Pattern di controllo obbligatori per l'automazione interfaccia utente

La seguente tabella elenca i criteri di controllo di UI Automation che devono essere supportati dai controlli barra menu. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto tecnico Note
IExpandCollapseProvider Dipende da Se il controllo può essere espanso o compresso, implementare IExpandCollapseProvider.
IDockProvider Dipende da Se il controllo può essere ancorato a parti diverse della schermata, implementare IDockProvider.
ITransformProvider Dipende da Se il controllo può essere ridimensionato, ruotato o spostato, deve implementare ITransformProvider.

Eventi di automazione interfaccia utente obbligatori

La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli barra menu. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di UI Automation Supporto/valore Note
Evento di modifica della proprietàBoundingRectangleProperty . Richiesto None
Evento di modifica della proprietàIsOffscreenProperty . Richiesto None
Evento di modifica della proprietàIsEnabledProperty . Richiesto None
Evento di modifica della proprietàExpandCollapseStateProperty . Dipende da None
AutomationFocusChangedEvent Richiesto None
StructureChangedEvent Richiesto None

Vedi anche