Condividi tramite

Supporto dell'automazione dell'interfaccia utente per il controllo di tipo gruppo

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 dell'automazione dell'interfaccia utente per il tipo di controllo Gruppo. 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 modelli di controllo di automazione interfaccia utente.

Il controllo gruppo rappresenta un nodo all'interno di una gerarchia. Il tipo di controllo Gruppo crea una separazione nell'albero di automazione interfaccia utente in modo che gli elementi raggruppati abbiano una divisione logica all'interno dell'albero di automazione interfaccia utente.

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 Group. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di gruppo, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la visualizzazione controlli e la visualizzazione contenuto dell'albero di automazione interfaccia utente relativa ai controlli di gruppo e descrive cosa può essere contenuto in ogni visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.

Vista di controllo Visualizzazione contenuto
Gruppo

- 0 o molti controlli		 Gruppo

- 0 o molti controlli

In genere, i controlli di gruppo avranno il supporto dell'automazione interfaccia utente per il tipo di controllo ListItem, il supporto dell'automazione interfaccia utente per il tipo di controllo TreeItem o il supporto dell'automazione interfaccia utente per il tipo di controllo DataItem presenti sotto di essi nel sottoalbero. Poiché 'Group' è un contenitore generico, è possibile che qualsiasi tipo di controllo sia incluso nel controllo Group nell'albero.

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 di gruppo. 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 gruppo ottiene in genere il nome dal testo che etichetta il controllo.
LabeledByProperty Vedere le note. I controlli di gruppo sono in genere auto-etichettati. In questi casi restituisce null qui. Se è presente un'etichetta di testo statica per il gruppo, tale etichetta deve essere restituita come valore della proprietà LabeledBy.
ControlTypeProperty Gruppo Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty gruppo Stringa localizzata corrispondente al tipo di controllo Gruppo.
IsContentElementProperty Vero Il controllo gruppo è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
IsControlElementProperty Vero Il gruppo di calendario è sempre incluso nella visualizzazione di controllo dell'albero di automazione dell'interfaccia utente.

Modelli di controllo di automazione interfaccia utente necessari

La tabella seguente elenca i pattern di controllo di automazione dell'interfaccia utente necessari per il tipo di controllo Group. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Assistenza Note
IExpandCollapseProvider Dipende da I controlli di gruppo che possono essere usati per visualizzare o nascondere le informazioni devono supportare lo schema Espandi Comprimi.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli di gruppo. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.

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
Evento di cambiamento della proprietà ExpandCollapseStateProperty. Dipende da Nessuno
Evento di cambiamento della proprietà ToggleStateProperty. Dipende da Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche