Supporto per l'automazione dell'interfaccia utente del tipo di controllo Menu
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.
Questo argomento fornisce informazioni sul supporto per UI Automation Microsoft per il tipo di controllo Menu. Viene descritta la struttura ad albero di UI Automation Microsoft del controllo e vengono descritte le proprietà e i criteri di controllo per scenari specifici.
Un controllo menu consente l'organizzazione gerarchica degli elementi associati a comandi e gestori eventi. In una tipica applicazione Windows Microsoft, una barra dei menu contiene più pulsanti di menu (ad esempio File, Modifica e Finestra), mentre 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 seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di UI Automation necessari per il tipo di controllo Menu. I requisiti di UI Automation si applicano a tutti i controlli elenco, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di UI Automation che riguarda i controlli menu e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Menu - MenuItem (1 o molti) |
Non applicabile (a meno che il controllo menu non sia un menu di scelta rapida che è un elemento padre di un oggetto che non è una voce di menu) - MenuItem (1 o molti) |
I controlli menu vengono sempre visualizzati nella visualizzazione controlli e nella visualizzazione contenuto dell'albero di UI Automation. I tipi di controllo menu devono essere visualizzati sotto il controllo a cui si riferiscono le relative informazioni. I client di automazione interfaccia utente devono attendere l'evento MenuOpenedEvent per garantire che le informazioni fornite dai controlli menu vengano recuperate in modo coerente. I controlli menu di scelta rapida rappresentano un caso speciale. Vengono visualizzati come elementi figlio del desktop.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di UI Automation il cui valore o definizione è particolarmente rilevante per il tipo di controllo Menu. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| NameProperty | Non supportato | Il controllo menu non richiede l'impostazione della proprietà Name. |
| LabeledByProperty | Null |
Non è prevista alcuna etichetta con un controllo menu standard. |
| ControlTypeProperty | Menu | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Falso | Il controllo menu non viene incluso nella visualizzazione contenuto dell'albero di UI Automation. |
| IsControlElementProperty | Vero | Il controllo menu è sempre incluso nella vista controllo dell'albero di UI Automation. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
Non sono presenti pattern di controllo obbligatori per il tipo di controllo Menu.
Eventi di automazione interfaccia utente obbligatori
I controlli menu devono generare un evento MenuOpenedEvent quando vengono visualizzati sullo schermo. MenuOpenedEvent includerà il testo del controllo. MenuClosedEvent deve essere generato quando un menu viene rimosso dallo schermo.
La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli menu. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di UI Automation | Supporto/valore | Note |
|---|---|---|
| MenuOpenedEvent | Richiesto | None |
| MenuClosedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |