Supporto per automazione interfaccia utente del tipo di controllo MenuItem

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente Microsoft per il tipo di controllo MenuItem. Viene descritta la struttura ad albero di automazione interfaccia utente Microsoft del controllo e vengono fornite le proprietà e i pattern di controllo richiesti per il tipo di controllo MenuItem.

Un controllo menu consente l'organizzazione gerarchica di elementi associati a comandi e gestori eventi. In un'applicazione Microsoft Windows tipica, una barra dei menu contiene molte voci (ad esempio File, Modifica e Finestra), ciascuna delle quali consente di visualizzare un menu. Un menu contiene un insieme di voci di menu (ad esempio Nuovo, Apri e Chiudi) che possono essere espanse per visualizzare voci di menu aggiuntive o scelte per eseguire un'azione specifica.

Nelle sezioni riportate di seguito vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo MenuItem. I requisiti di automazione interfaccia utente si applicano a tutti i controlli elenco, Windows Presentation Foundation (WPF), Win32 o Windows Form.

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 per voce di menu
Eventi di automazione interfaccia utente obbligatori
Problemi legacy
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 automazione interfaccia utente relativamente ai controlli voce di menu e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
MenuItem "?" Menu MenuItem "Argomenti della Guida" MenuItem "Informazioni su Blocco note"	MenuItem "?" MenuItem "Argomenti della Guida" MenuItem "Informazioni su Blocco note"

La visualizzazione controlli del controllo voce di menu presenta la struttura ad albero di automazione interfaccia utente riportata in precedenza. Si noti che la voce di menu per ? sulla barra dei menu è stata aggiunta per illustrare meglio la struttura.

Per la visualizzazione contenuto, Menu è assente dalla struttura ad albero di automazione interfaccia utente perché non apporta informazioni significative all'utente finale.

Proprietà di automazione interfaccia utente obbligatorie

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

Proprietà	Valore	Descrizione
AutomationIdProperty()	Vedere le note.	Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.
BoundingRectangleProperty	Vedere le note.	Il rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty	Vedere le note.	Supportata se è presente un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.
IsKeyboardFocusableProperty	Vedere le note.	Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
NameProperty	Vedere le note.	Il controllo delle voci di menu è incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente e viene etichettato automaticamente con un nome.
LabeledByProperty	Null	Nessuna etichetta.
ControlTypeProperty	MenuItem	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"voce di menu"	Stringa localizzata che corrisponde al tipo di controllo MenuItem.
IsContentElementProperty	True	Il controllo delle voci di menu non è mai incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.
IsControlElementProperty	True	Il controllo voce di menu deve essere sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati dai controlli voce di menu. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern	Supporto/Valore	Note
IExpandCollapseProvider	A seconda dei casi	Se il controllo può essere espanso o compresso, implementare IExpandCollapseProvider.
IInvokeProvider	A seconda dei casi	Se il controllo esegue una sola azione o comando, implementare IInvokeProvider.
IToggleProvider	A seconda dei casi	Se il controllo rappresenta un'opzione che può essere attivata o disattivata, implementare IToggleProvider.
ISelectionItemProvider	A seconda dei casi	Se il controllo viene utilizzato per eseguire la selezione da un elenco di opzioni tra voci di menu, implementare ISelectionItemProvider.

Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente Microsoft associati al controllo voce di menu.

Evento	Supporto	Descrizione
InvokedEvent	A seconda dei casi	Deve essere generato se il controllo supporta il pattern di controllo Invoke.
Evento di proprietà modificata ToggleStateProperty.	A seconda dei casi	Deve essere generato se il controllo supporta il pattern di controllo Toggle.
Evento di proprietà modificata ExpandCollapseStateProperty.	A seconda dei casi	Deve essere generato se il controllo supporta il pattern di controllo Expand Collapse.
ElementSelectedEvent	A seconda dei casi	Nessuno.

Eventi di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli voce di menu. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente	Supporto/Valore	Note
InvokedEvent	A seconda dei casi	Nessuno
ElementAddedToSelectionEvent	A seconda dei casi	Nessuno
ElementRemovedFromSelectionEvent	A seconda dei casi	Nessuno
ElementSelectedEvent	A seconda dei casi	Nessuno
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
Evento di proprietà modificata ToggleStateProperty.	A seconda dei casi	Nessuno
AutomationFocusChangedEvent	Obbligatorio	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno

Problemi legacy

Il pattern Toggle è supportato solo quando la voce di menu di Win32 viene selezionata e può essere impostata a livello di codice come necessaria per il supporto del pattern Toggle. Poiché la voce di menu di Win32 non espone la relativa possibilità di essere selezionata, viene supportato il pattern Invoke quando la voce di menu non è selezionata. Viene concessa un'eccezione per supportare sempre il pattern Invoke anche per voci di menu che dovrebbero supportare solo il pattern Toggle. In questo modo si evita la confusione dei client relativamente al fatto che un elemento che supporta il pattern Invoke (quando la voce di menu è deselezionata) non supporta più tale pattern quando la voce viene selezionata.