Supporto per automazione interfaccia utente del tipo di controllo Group
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.
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente per il tipo di controllo Gruppo. 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 con i rispettivi valori e criteri di controllo.
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 tale che gli elementi raggruppati siano divisi logicamente all'interno dell'albero di Automazione interfaccia utente.
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 Gruppo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di gruppo, che si tratti di Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli Gruppo e descrive cosa può essere contenuto in ogni vista. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Raggruppa - 0 o molti controlli |
Raggruppa - 0 o molti controlli |
In genere i controlli di gruppo avranno, per i tipi di controllo: il supporto di 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 si trovi sotto il controllo gruppo all'interno dell'albero.
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 gruppo. 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 gruppo in genere ricava il proprio nome dal testo dell'etichetta applicata al controllo. |
| LabeledByProperty | Vedere le note. | I controlli gruppo sono in genere associati a un'etichetta automatica. In questi casi, restituire null qui. Se per il gruppo è presente un'etichetta di testo statico, tale etichetta deve essere restituita come valore della proprietà LabeledBy. |
| ControlTypeProperty | Raggruppa | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "group" | Stringa localizzata corrispondente al tipo di controllo Group. |
| IsContentElementProperty | Vero | Il controllo gruppo è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo gruppo è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i pattern di controllo di Automazione interfaccia utente che devono essere supportati dal tipo di controllo Group. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IExpandCollapseProvider | Dipende da | I controlli gruppo che possono essere usati per mostrare o nascondere informazioni devono supportare il pattern ExpandCollapse. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli gruppo. 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 |
| Evento di modifica della proprietàExpandCollapseStateProperty . | Dipende da | None |
| Evento di modifica della proprietàToggleStateProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |