Tipo di controllo TitleBar

  • Articolo

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

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
  • TitleBar
    • Menu (0 o 1)
    • Button (0 o più)
 (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

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente