Supporto di automazione interfaccia utente per il tipo di controllo MenuBar

Nota
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese).

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 al fine di 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 pattern 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 i comandi e le opzioni di un'applicazione.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern 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, sia Windows Presentation Foundation (WPF), Win32 che Windows Forms.

Nel presente argomento sono contenute le seguenti sezioni.

• Struttura ad albero di automazione interfaccia utente obbligatoria
• Proprietà di automazione interfaccia utente obbligatorie
• Pattern di controllo di automazione interfaccia utente obbligatori
• Eventi di automazione interfaccia utente obbligatori
• Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di UI Automation relativamente ai controlli barra di menu e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di UI Automation, vedere Cenni preliminari sulla struttura ad albero di automazione dell'interfaccia utente.

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, all'interno della struttura. Questi controlli aggiuntivi corrispondono agli "altri controlli" elencati sopra nelle visualizzazioni controlli e contenuto.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di UI Automation il cui valore o la cui definizione è particolarmente rilevante per i controlli barra dei menu. Per ulteriori informazioni sulle proprietà dell'UI Automation, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di UI Automation	Valore	Note
BoundingRectangleProperty	Vedere le note.	Il valore esposto da questa proprietà deve includere tutti i controlli contenuti all'interno.
NameProperty	Vedere le note.	Per il controllo barra dei menu non è necessario un nome, a meno che l'applicazione non contenga più barre dei menu. Se in un'applicazione sono presenti più barre dei menu, questa proprietà deve essere utilizzata per esporre nomi distinti, ad esempio "Formattazione" o "Struttura."
LabeledByProperty	Null	I controlli barra dei menu non includono mai un'etichetta.
ControlTypeProperty	MenuBar	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"barra dei menu"	Stringa localizzata che corrisponde al tipo di controllo MenuBar.
IsContentElementProperty	True	Il controllo barra dei menu è sempre incluso nella visualizzazione contenuto della struttura ad albero di UI Automation.
IsControlElementProperty	True	Il controllo barra dei menu è sempre incluso nella visualizzazione controlli della struttura ad albero di UI Automation.
IsOffscreenProperty	Vedere le note.	Il valore di questa proprietà varia a seconda che il controllo sia visualizzabile sullo schermo.
OrientationProperty	A seconda dei casi	Questa proprietà espone se il controllo barra dei menu è orizzontale o verticale.
IsKeyboardFocusableProperty	True	I controlli barra dei menu possono ricevere lo stato attivo, perché i controlli che contengono presentano questa caratteristica.
HelpTextProperty	Vedere le note.	Nessuno scenario per i casi in cui il testo della Guida sia richiesto per un controllo barra dei menu.
AcceleratorKeyProperty	Null	Le barre dei menu non includono mai tasti di scelta rapida.
AccessKeyProperty	"ALT"	Il tasto ALT deve sempre spostare lo stato attivo sulla barra dei menu all'interno dell'applicazione.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di UI Automation che devono essere supportati dai controlli barra dei menu. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo	Supporto	Note
IExpandCollapseProvider	A seconda dei casi	Se il controllo può essere espanso o compresso, implementare IExpandCollapseProvider.
IDockProvider	A seconda dei casi	Se il controllo può essere ancorato a parti diverse dello schermo, implementare IDockProvider.
ITransformProvider	A seconda dei casi	Se il controllo può essere ridimensionato, ruotato o spostato deve implementare ITransformProvider.

Eventi di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati gli eventi di UI Automation che devono essere supportati da tutti i controlli barra dei menu. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento UI Automation	Supporto/Valore	Note
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata ExpandCollapseStateProperty.	A seconda dei casi	Nessuno
AutomationFocusChangedEvent	Obbligatorio	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno

Vedere anche

Riferimenti

MenuBar

Concetti

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

Cenni preliminari su automazione interfaccia utente