Tipo di controllo ToolBar
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo ToolBar. 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, le proprietà, i pattern di controllo e gli eventi necessari per la barra degli strumenti tipo di controllo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della barra degli strumenti 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 della barra degli strumenti 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 |
|---|---|
|
|
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à pertinenti
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo ToolBar. 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_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile. |
| UIA_ControlTypePropertyId | toolBar | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| UIA_IsContentElementPropertyId | VERO | Il controllo barra degli strumenti è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo barra degli strumenti è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | NULLO | Un controllo barra degli strumenti non ha mai un'etichetta. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo ToolBar. Il valore predefinito è "barra degli strumenti" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Dipende | 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ù di uno, ognuno deve avere un nome distintivo(ad esempio, "Formattazione" o "Struttura"). |
Modelli di controllo obbligatori
La tabella seguente elenca i modelli 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 | Appoggiare | Note |
|---|---|---|
| IDockProvider | Dipende | Se la barra degli strumenti può essere ancorata a diverse parti dello schermo, deve supportare il pattern di controllo Dock. |
| IExpandCollapseProvider | Dipende | Se la barra degli strumenti può essere espansa e compressa per visualizzare più elementi, deve supportare il pattern di controllo ExpandCollapse. |
| ITransformProvider | Dipende | Se la barra degli strumenti può essere ridimensionata, ruotata o spostata, deve supportare il pattern di controllo Transform. |
Eventi obbligatori
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli della barra degli strumenti. 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_ExpandCollapseExpandCollapseStatePropertyId evento di modifica delle proprietà. | Se il controllo supporta il ExpandCollapse pattern di controllo, deve supportare questo evento. |
| 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_StructureChangedEventId |
Argomenti correlati