Tipo di controllo ToolBar
Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente 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 Automazione interfaccia utente, le proprietà, i modelli 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 in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Modelli di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero 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 Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Un controllo della barra degli strumenti può contenere qualsiasi tipo di controllo all'interno del relativo sottoalbero. In genere contengono pulsanti, caselle combinate e pulsanti di menu combinato.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per il tipo di controllo ToolBar. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | 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 Automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable. |
| UIA_ControlTypePropertyId | Barra degli strumenti | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| UIA_IsContentElementPropertyId | TRUE | Il controllo della barra degli strumenti è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo della barra degli strumenti è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | NULL | Un controllo della 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 da | Il controllo della barra degli strumenti non richiede un nome a meno che non venga usato più di uno all'interno di un'applicazione. Se sono presenti più di uno, ogni deve avere un nome distinto ,ad esempio "Formattazione" o "Struttura". |
Modelli di controllo obbligatori
Nella tabella seguente sono elencati i modelli di controllo 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.
| Pattern di controllo | Supporto | Note |
|---|---|---|
| IDockProvider | Dipende da | Se la barra degli strumenti può essere ancorata a parti diverse dello schermo, deve supportare il modello di controllo Dock . |
| IExpandCollapseProvider | Dipende da | Se la barra degli strumenti può essere espansa e compressa per visualizzare altri elementi, deve supportare il modello di controllo ExpandCollapse . |
| ITransformProvider | Dipende da | Se la barra degli strumenti può essere ridimensionata, ruotata o spostata, deve supportare il modello di controllo Trasforma . |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli della barra degli strumenti. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Automazione interfaccia utente evento | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento modificato dalla proprietà. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo ExpandCollapse , deve supportare questo evento. |
| UIA_IsEnabledPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento. |
| UIA_StructureChangedEventId |
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente