Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo Header. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.
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 Header. I requisiti di Automazione UI si applicano a tutti i controlli di intestazione, che siano Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione dei controlli e quella del contenuto nell'albero di automazione dell'interfaccia utente che riguarda i controlli dell'intestazione e descrive cosa possa essere contenuto in ognuna di queste visualizzazioni. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| Intestazione - HeaderItem (1 o più) |
Nessuno |
I controlli intestazione hanno sempre 1 o più elementi figlio nella vista di controllo dell'albero dell'Automazione dell'Interfaccia Utente.
I controlli intestazione hanno zero elementi figlio nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
Proprietà di automazione interfaccia utente necessarie
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 Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | 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. |
| LabeledByProperty |
Null. |
I controlli intestazione non hanno un'etichetta statica. |
| ControlTypeProperty | Intestazione | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "intestazione" | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| OrientationProperty | Orizzontale | Il valore di questa proprietà indica la posizione del controllo dell'intestazione, sia che si tratti di un'intestazione di riga o di un'intestazione di colonna. |
| IsContentElementProperty | Falso | Il controllo intestazione non è incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo intestazione è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i pattern di controllo UI Automation che devono essere supportati da tutti i controlli di 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 | Assistenza | Note |
|---|---|---|
| ITransformProvider | Dipende da | Implementa questo pattern di controllo se il controllo dell'intestazione può essere ridimensionato. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi dell'automazione dell'interfaccia utente che devono essere supportati da tutti i controlli d'intestazione. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |