Supporto per l'automazione dell'interfaccia utente del tipo di controllo Menu

Aggiornamento: novembre 2007

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

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 molti pulsanti (ad esempio File, Modifica e Finestra), ciascuno dei 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 Menu. 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 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 automazione interfaccia utente relativamente ai controlli 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

  • Menu

    • MenuItem (1 o molti)

  • Menu

    • MenuItem (1 o molti)

I controlli menu vengono sempre visualizzati nella visualizzazione controlli e nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente. I tipi di controlli menu sono visualizzati sotto il controllo al quale si riferiscono le relative informazioni. I client di automazione interfaccia utente devono restare in ascolto di MenuOpenedEvent per garantire che le informazioni fornite dai controlli menu vengano ottenute in modo coerente. I controlli menu di scelta rapida costituiscono un caso a parte, poiché sono interpretati come figli del desktop.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella riportata di seguito vengono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i tipi di controlli Menu. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente

Valore

Note

NameProperty

Non supportato

Il controllo menu non richiede l'impostazione di una proprietà Name.

LabeledByProperty

Null

Nessuna etichetta.

ControlTypeProperty

Menu

Questo valore è identico per tutti i framework dell'interfaccia utente.

IsContentElementProperty

False

Il controllo menu non è incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.

IsControlElementProperty

True

Il controllo menu è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.

Pattern di controllo di automazione interfaccia utente obbligatori

Non vi sono pattern di controllo obbligatori per il tipo di controllo Menu.

Eventi di automazione interfaccia utente obbligatori

I controlli menu devono generare MenuOpenedEvent quando vengono visualizzati sullo schermo. L'evento MenuOpenedEvent include il testo del controllo. Quando un menu viene rimosso dallo schermo, è necessario generare l'evento MenuClosedEvent.

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

Evento di automazione interfaccia utente

Supporto/Valore

Note

MenuOpenedEvent

Obbligatorio

Nessuno

MenuClosedEvent

Obbligatorio

Nessuno

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

Nessuno

AutomationFocusChangedEvent

Obbligatorio

Nessuno

StructureChangedEvent

Obbligatorio

Nessuno

Vedere anche

Concetti

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

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

Menu