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 dell'automazione interfaccia utente per il tipo di controllo ToolBar. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e i pattern di controllo. I controlli della barra degli strumenti consentono agli utenti finali di attivare comandi e strumenti contenuti in un'applicazione.
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 ToolBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della barra degli strumenti, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.
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 della barra degli strumenti 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 |
|---|---|
| Barra degli strumenti - Vari controlli (0 o più) |
Barra degli strumenti - Vari controlli (0 o più) |
Un controllo barra degli strumenti può contenere qualsiasi tipo di controllo all'interno del relativo sottoalbero. Spesso contengono pulsanti, caselle combinate e pulsanti di divisione.
Proprietà di automazione interfaccia utente necessarie
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli della barra degli strumenti. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | Dipende da | Il controllo barra degli strumenti non richiede un nome, a meno che non vengano usati più di uno all'interno di un'applicazione. Se sono presenti più elementi, ognuno deve avere un nome distintivo (ad esempio, Formattazione o Struttura). |
| LabeledByProperty | Null |
I controlli della barra degli strumenti non hanno mai un'etichetta. |
| ControlTypeProperty | Barra degli strumenti | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "barra degli strumenti" | Stringa localizzata corrispondente al tipo di controllo ToolBar. |
| IsContentElementProperty | Vero | Il controllo della barra degli strumenti è sempre presente. |
| IsControlElementProperty | Vero | Il controllo della barra degli strumenti deve essere sempre un controllo. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli della barra degli strumenti. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.
| Pattern di controllo | Assistenza | Note |
|---|---|---|
| ExpandCollapsePattern | Dipende da | Se la barra degli strumenti può essere espansa e compressa per visualizzare più elementi, deve supportare questo modello. |
| DockPattern | Dipende da | Se la barra degli strumenti può essere ancorata a diverse parti dello schermo, deve supportare questo modello. |
| TransformPattern | Dipende da | Se la barra degli strumenti può essere ridimensionata, ruotata o spostata, deve supportare questo modello. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli della barra degli strumenti. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| BoundingRectangleProperty evento modifica-proprietà. | Obbligatorio | Nessuno |
| IsOffscreenProperty evento modifica-proprietà. | Obbligatorio | Nessuno |
| IsEnabledProperty evento modifica-proprietà. | Obbligatorio | Nessuno |
| ExpandCollapseStateProperty evento modifica-proprietà. | Dipende da | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |