Condividi tramite


Tipo di controllo TitleBar

Questo argomento fornisce informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo TitleBar. Un controllo barra del titolo rappresenta un titolo o una barra della didascalia in una finestra.

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 TitleBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della barra del titolo 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

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli barra del titolo 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
  • TitleBar
    • Menu (0 o 1)
    • Pulsante (0 o più)
(Non applicabile; il controllo barra del titolo non ha contenuto)

 

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo TitleBar. 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. Il valore esposto da questa proprietà deve includere tutti i controlli contenuti al suo interno.
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 TitleBar Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
UIA_IsContentElementPropertyId FALSO Il controllo barra del titolo non è mai incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo barra del titolo è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId FALSO Un controllo barra del titolo non ha mai lo stato attivo della tastiera.
UIA_IsOffscreenPropertyId Dipende 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 alcun pattern di controllo. La funzionalità viene esposta tramite il pattern di controllo finestra di nel tipo di controllo Window.

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli della barra del titolo. 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_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

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente