Tipo di controllo TitleBar
Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo TitleBar. Un controllo barra del titolo rappresenta un titolo o una barra didascalia in una finestra.
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 TitleBar. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli della barra del titolo 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 del titolo 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 |
|---|---|
|
(Non applicabile; il controllo della barra del titolo non ha contenuto) |
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo TitleBar. 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 valore esposto da questa proprietà deve includere tutti i controlli contenuti. |
| 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 | Titlebar | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| UIA_IsContentElementPropertyId | FALSE | Il controllo barra del titolo non è mai incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo barra del titolo è sempre incluso nella visualizzazione di controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | FALSE | Un controllo della barra del titolo non ha mai lo stato attivo sulla tastiera. |
| UIA_IsOffscreenPropertyId | Dipende da | Un controllo barra del titolo restituisce un valore a seconda che sia visibile sullo schermo. |
| UIA_LabeledByPropertyId | Vedere le note. | Un controllo barra del titolo in genere non ha un'etichetta. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo TitleBar. Il valore predefinito è "barra del titolo" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | "" | Una barra del titolo non è contenuto; le informazioni testuali vengono esposte dal nome della finestra padre. |
Modelli di controllo obbligatori
Il tipo di controllo TitleBar non è necessario per supportare i modelli di controllo. La sua funzionalità viene esposta tramite il modello di controllo Window nel tipo di controllo Finestra .
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli della barra del titolo. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Automazione interfaccia utente evento | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento modificato dalla proprietà. | |
| 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