Condividi tramite


Supporto di automazione interfaccia utente per il tipo di controllo Header

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo intestazione. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.

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

Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente necessari per il tipo di controllo intestazione. I requisiti di automazione interfaccia utente si applicano a tutti i controlli intestazione, siano Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Struttura ad albero di automazione interfaccia utente obbligatoria

La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli intestazione e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
Intestazione

- HeaderItem (1 o più)
None

I controlli intestazione hanno sempre 1 o più elementi figlio nella visualizzazione controlli dell'albero di Automazione interfaccia utente.

I controlli intestazione non hanno alcun elemento figlio nella visualizzazione contenuto dell'albero di Automazione interfaccia utente.

Proprietà di automazione interfaccia utente obbligatorie

La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli intestazione. Per maggiori informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione.
BoundingRectangleProperty Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
NameProperty Vedere le note. Il controllo intestazione richiede un nome se è presente più di un'intestazione di riga o più di un'intestazione di colonna. Identifica le informazioni all'interno dell'intestazione.
LabeledByProperty Null. I controlli intestazione in genere non hanno un'etichetta statica.
ControlTypeProperty Intestazione Questo valore è uguale per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty "header" Questo valore è uguale per tutti i framework dell'interfaccia utente.
OrientationProperty Orizzontale Il valore di questa proprietà espone la posizione del controllo intestazione, indipendentemente dal fatto che sia un'intestazione di riga o un'intestazione di colonna.
IsContentElementProperty Falso Il controllo intestazione non viene incluso nella visualizzazione contenuto dell'albero di Automazione interfaccia utente.
IsControlElementProperty Vero Il controllo intestazione viene sempre incluso nella visualizzazione controlli dell'albero di Automazione interfaccia utente.

Pattern di controllo obbligatori per l'automazione interfaccia utente

La seguente tabella elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati da tutti i controlli intestazione. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto tecnico Note
ITransformProvider Dipende da Implementare questo pattern di controllo se il controllo intestazione può essere ridimensionato.

Eventi di automazione interfaccia utente obbligatori

La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli intestazione. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di Automazione interfaccia utente Supporto tecnico Note
Evento di modifica della proprietàBoundingRectangleProperty . Richiesto None
Evento di modifica della proprietàIsOffscreenProperty . Richiesto None
Evento di modifica della proprietàIsEnabledProperty . Richiesto None
AutomationFocusChangedEvent Richiesto None
StructureChangedEvent Richiesto None

Vedi anche