Supporto per automazione interfaccia utente del tipo di controllo HeaderItem
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.
Questo argomento fornisce informazioni sul supporto per UI Automation per il tipo di controllo HeaderItem. In UI Automation, 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 UI Automation, i valori delle proprietà di UI Automation e i criteri di controllo.
Il tipo di controllo HeaderItem fornisce un'etichetta visiva per una riga o colonna di informazioni.
I controlli elemento intestazione sono esempi di controlli che implementano il tipo di controllo HeaderItem. I requisiti di UI Automation nelle sezioni seguenti si applicano a tutti i controlli intestazione, siano essi 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 UI Automation che riguarda i controlli elemento intestazione e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| HeaderItem | None |
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di UI Automation il cui valore o definizione è particolarmente rilevante per i controlli elemento intestazione. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation 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 elemento intestazione è sempre associato a un'etichetta automatica. |
| LabeledByProperty | Null. |
I controlli elemento intestazione in genere non hanno un'etichetta statica. |
| ControlTypeProperty | HeaderItem | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "header item" | Stringa localizzata per il tipo di controllo HeaderItem. |
| IsContentElementProperty | Falso | Il controllo elemento intestazione non viene incluso nella visualizzazione contenuto dell'albero di UI Automation. |
| IsControlElementProperty | Vero | Il controllo elemento intestazione viene sempre incluso nella visualizzazione controlli dell'albero di UI Automation. |
| ItemStatusProperty | Vedere le note. | Questa proprietà fornisce informazioni per i tipi di ordinamento per l'elemento dell'intestazione. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di UI Automation che devono essere supportati da tutti i controlli elemento 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 elemento intestazione può essere ridimensionato. |
| IInvokeProvider | Dipende da | Implementare questo pattern di controllo se il controllo elemento intestazione può essere selezionato per ordinare i dati. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli elemento intestazione. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di UI Automation | Supporto tecnico | Note |
|---|---|---|
| InvokedEvent | Dipende da | None |
| 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 |