Tipo di controllo menu
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo menu.
Un controllo menu consente l'organizzazione gerarchica di elementi associati ai comandi e ai gestori eventi. In un'applicazione tipica di Microsoft Windows, una barra dei menu contiene diversi pulsanti di menu ( ad esempio File, Modificae Finestra) e ogni pulsante di menu visualizza un menu. Un menu contiene una raccolta di voci di menu( ad esempio Nuovo, Aprie Chiudi), che possono essere espanse per visualizzare voci di menu aggiuntive o per eseguire un'azione specifica quando si fa clic.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per il Menu tipo di controllo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di menu in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di 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 ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
I controlli menu vengono sempre visualizzati nella visualizzazione controlli e nella visualizzazione contenuto dell'albero di automazione interfaccia utente. I controlli menu dovrebbero essere visualizzati sotto il controllo a cui fanno riferimento le informazioni. I client di automazione interfaccia utente possono ascoltare UIA_MenuOpenedEventId per garantire che ottengano in modo coerente le informazioni trasmesse dai controlli menu. I controlli menu di scelta rapida sono 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 controlli di modifica e 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à di 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 delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_ControlTypePropertyId | menu | |
| UIA_IsContentElementPropertyId | VERO | Il controllo menu è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo menu è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_LabeledByPropertyId | NULLO | Non è prevista alcuna etichetta con un controllo menu tipico. |
| UIA_NamePropertyId | Vedere le note. | Il controllo menu non richiede l'impostazione di una proprietà Nome oppure potrebbe avere lo stesso nome del controllo associato, ad esempio una voce di menu che ha aperto il sottomenu. |
Modelli di controllo obbligatori
Non esistono pattern di controllo necessari 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 dallo schermo.
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli menu. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_MenuClosedEventId | |
| UIA_MenuOpenedEventId | |
| UIA_StructureChangedEventId |
Argomenti correlati