Condividi tramite

Tipo di controllo intestazione

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo intestazione.

Il controllo intestazione fornisce un contenitore visivo per le etichette per le righe o le colonne di informazioni.

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 intestazione. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di intestazione 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 di intestazione 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
  • Intestazione
    • HeaderItem (1 o più)
 (Non applicabile)

 

I controlli intestazione hanno sempre uno o più elementi figlio nella visualizzazione controllo dell'albero di automazione interfaccia utente.

I controlli intestazione hanno zero elementi figlio nella visualizzazione contenuto dell'albero di automazione interfaccia utente.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli intestazione. 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 in tutti i controlli di un'applicazione.
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 intestazione
UIA_IsContentElementPropertyId FALSO Il controllo intestazione non è incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo intestazione è 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 I controlli intestazione non hanno un'etichetta statica.
UIA_LocalizedControlTypePropertyId Vedere le note. Il valore predefinito è "intestazione" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo intestazione richiede un nome se sono presenti più intestazioni di riga o più intestazioni di colonna. Identifica le informazioni all'interno dell'intestazione.
UIA_OrientationPropertyId OrientationType_Horizontal o OrientationType_Vertical Il valore di questa proprietà espone la posizione del controllo intestazione, indipendentemente dal fatto che si tratti di un'intestazione di riga (OrientationType_Horizontal) o di un'intestazione di colonna (OrientationType_Vertical).

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo di automazione interfaccia utente necessari per supportare i controlli intestazione. 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
ITransformProvider Dipende Implementare il pattern di controllo Transform se il controllo intestazione può essere ridimensionato.

 

Eventi obbligatori

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