Tipo di controllo menu

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Menu.

Un controllo menu consente l'organizzazione gerarchica degli elementi associati a comandi e gestori eventi. In una tipica applicazione Di Microsoft Windows, una barra dei menu contiene diversi pulsanti di menu (ad esempio File, Modifica e Finestra) e ogni pulsante di menu visualizza un menu. Un menu contiene una raccolta di voci di menu (ad esempio Nuovo, Aprie Chiudi), che può essere espansa per visualizzare altre voci di menu che, se selezionate, consentono di eseguire un'azione specifica.

Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Menu. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli menu in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli menu e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Menu
    • MenuItem (1 o molti)
    • Altri controlli (0 o molti)
  • Menu
    • MenuItem (1 o molti)
    • Altri controlli (0 o molti)

 

I controlli menu vengono sempre visualizzati nella visualizzazione controlli e nella visualizzazione contenuto dell'albero Automazione interfaccia utente. I controlli menu dovrebbero essere visualizzati sotto il controllo a cui fanno riferimento le informazioni. Automazione interfaccia utente client possono restare in ascolto di UIA_MenuOpenedEventId per assicurarsi che ottengano in modo coerente le informazioni trasmesse dai controlli menu. I controlli menu di scelta rapida rappresentano un caso speciale. Possono essere visualizzati come elementi figlio del desktop o di una finestra dell'applicazione di primo livello.

Un controllo 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 nella tabella precedente nelle visualizzazioni controllo e contenuto.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo Menu. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Recupero di proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_ControlTypePropertyId Menu
UIA_IsContentElementPropertyId TRUE Il controllo menu è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo menu è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_LabeledByPropertyId NULL Non è prevista alcuna etichetta con un controllo menu standard.
UIA_NamePropertyId Vedere le note. Il controllo menu non richiede l'impostazione di una proprietà Name oppure può avere lo stesso nome del controllo associato, ad esempio una voce di menu che ha aperto il sottomenu.

 

Pattern di controllo obbligatori

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

Eventi obbligatori

I controlli menu devono generare l'evento UIA_MenuOpenedEventId quando vengono visualizzati sullo schermo. L'evento UIA_MenuOpenedEventId includerà il testo del controllo. L'evento UIA_MenuClosedEventId deve essere generato quando un menu scompare dalla schermata.

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli di menu. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente