Supporto di automazione interfaccia utente per il tipo di controllo MenuBar
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.
In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo MenuBar. In UI Automation, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di UI Automation, i valori delle proprietà di UI Automation e i criteri di controllo.
I controlli barra dei menu sono un esempio di controlli che implementano il tipo di controllo MenuBar. Le barre dei menu consentono agli utenti di attivare comandi e opzioni contenuti in un'applicazione.
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 MenuBar. 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 barra 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 |
|---|---|
| MenuBar - MenuItem (1 o più) - Altri controlli (0 o molti) |
MenuBar - MenuItem (1 o più) - Altri controlli (0 o molti) |
I controlli barra dei menu possono contenere altri controlli, ad esempio controlli di modifica e caselle combinate, nella struttura. Questi controlli aggiuntivi corrispondono agli "altri controlli" elencati sopra nelle visualizzazioni controlli e contenuto.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di UI Automation il cui valore o definizione è particolarmente rilevante per i controlli barra menu. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| BoundingRectangleProperty | Vedere le note. | Il valore esposto da questa proprietà deve includere tutti i controlli contenuti. |
| NameProperty | Vedere le note. | Il controllo barra dei menu non necessita di un nome a meno che un'applicazione non abbia più di una barra dei menu. Se in un'applicazione sono presenti più barre dei menu, questa proprietà deve essere usata per esporre i nomi distinti, ad esempio "Formatting" o "Outlining". |
| LabeledByProperty | Null |
I controlli barra dei menu non includono mai un'etichetta. |
| ControlTypeProperty | MenuBar | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "menu bar" | Stringa localizzata corrispondente al tipo di controllo MenuBar. |
| IsContentElementProperty | Vero | Il controllo barra menu è sempre incluso nella vista contenuto dell'albero di UI Automation. |
| IsControlElementProperty | Vero | Il controllo barra menu è sempre incluso nella vista controllo dell'albero di UI Automation. |
| IsOffscreenProperty | Vedere le note. | Il valore di questa proprietà dipende dal fatto che il controllo sia visualizzabile o meno sullo schermo. |
| OrientationProperty | Dipende da | Questa proprietà espone l'orientamento orizzontale o verticale del controllo barra dei menu. |
| IsKeyboardFocusableProperty | Vero | I controlli barra dei menu hanno lo stato attivabile perché i controlli che contengono possono prendere lo stato attivo. |
| HelpTextProperty | Vedere le note. | Per un controllo barra dei menu non esistono scenari in cui è necessario il testo della Guida. |
| AcceleratorKeyProperty | Null |
Le barre dei menu non hanno mai tasti di scelta rapida. |
| AccessKeyProperty | "ALT" | Premendo ALT, la barra dei menu nell'applicazione deve sempre prendere lo stato attivo. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di UI Automation che devono essere supportati dai controlli barra menu. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IExpandCollapseProvider | Dipende da | Se il controllo può essere espanso o compresso, implementare IExpandCollapseProvider. |
| IDockProvider | Dipende da | Se il controllo può essere ancorato a parti diverse della schermata, implementare IDockProvider. |
| ITransformProvider | Dipende da | Se il controllo può essere ridimensionato, ruotato o spostato, deve implementare ITransformProvider. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli barra menu. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di UI Automation | Supporto/valore | Note |
|---|---|---|
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàExpandCollapseStateProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |