Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo Menu. Descrive la struttura ad albero di automazione interfaccia utente Microsoft del controllo e fornisce le proprietà e i pattern di controllo per scenari di controllo specifici.
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 di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Menu. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli elenco, sia che si tratti di Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione controlli e la visualizzazione contenuto dell'albero di automazione interfaccia utente relativa ai controlli menu e descrive cosa può essere contenuto in ogni visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| Menù - VoceDiMenu (1 o più) |
Non applicabile (a meno che il controllo menu non sia un menu contestuale che funge da padre per un oggetto che non è una voce di menu) - VoceDiMenu (1 o più) |
I controlli menu vengono sempre visualizzati nella visualizzazione controlli e nella visualizzazione contenuto dell'albero di automazione interfaccia utente. I tipi di controllo menu devono essere visualizzati sotto il controllo a cui fanno riferimento le informazioni. I client di automazione interfaccia utente devono ascoltare MenuOpenedEvent per assicurarsi che ottengano in modo coerente le informazioni trasmesse dai controlli del menu. I controlli menu di scelta rapida sono un caso speciale. Vengono visualizzati come elementi figlio del desktop.
Proprietà di automazione interfaccia utente necessarie
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 Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| NameProperty | Non supportato | Il controllo menu non richiede l'impostazione di una proprietà Name. |
| LabeledByProperty | Null |
Non è prevista alcuna etichetta con un controllo menu tipico. |
| ControlTypeProperty | Menù | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Falso | Il controllo menu non è incluso nella visualizzazione dei contenuti dell'albero dell'automazione dell'interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo menu è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
Modelli di controllo di automazione interfaccia utente necessari
Non esistono pattern di controllo necessari per il tipo di controllo Menu.
Eventi di automazione interfaccia utente necessari
I controlli del menu devono generare MenuOpenedEvent quando vengono visualizzati sullo schermo. Il MenuOpenedEvent includerà il testo del controllo. L'oggetto MenuClosedEvent deve essere generato quando un menu scompare dallo schermo.
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli menu. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Supporto/valore | Note |
|---|---|---|
| MenuOpenedEvent | Obbligatorio | Nessuno |
| MenuClosedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |