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
- Proprietà pertinenti
- Pattern di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
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 |
|---|---|
|
|
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 |
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente