Supporto di automazione interfaccia utente per il tipo di controllo ComboBox
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.
In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo ComboBox. 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 le linee guida specifiche per la struttura ad albero di UI Automation con i rispettivi valori, i modelli di controllo e gli eventi.
Una casella combinata è un casella di riepilogo combinata con un controllo statico o un controllo di modifica che visualizza l'elemento attualmente selezionato nel componente casella di riepilogo della casella combinata. Il componente casella di riepilogo del controllo viene visualizzato ogni volta o solo quando l'utente seleziona la freccia a discesa (un pulsante di comando) accanto al controllo. Se il campo di selezione è un controllo di modifica, l'utente può immettere informazioni non presenti nell'elenco. In caso contrario, l'utente può solo selezionare gli elementi nell'elenco.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di UI Automation necessari per il tipo di controllo ComboBox. I requisiti di UI Automation si applicano a tutti i controlli casella combinata, ovvero 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 casella combinata 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 |
|---|---|
| ComboBox - Modifica (0 o 1) - List (1) - List Item (elemento figlio di List; da 0 a molti) - Pulsante (1) |
ComboBox List Item (da 0 a molti) |
Il controllo di modifica nella visualizzazione controlli della casella combinata è necessario solo se la casella combinata può essere modificata in modo che accetti qualsiasi input, come nel caso della casella combinata nella finestra di dialogo Esegui.
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 casella combinata. 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. |
| ControlTypeProperty | ComboBox | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| HelpTextProperty | Vedere le note. | Il testo della Guida per i controlli casella combinata deve spiegare perché all'utente viene chiesto di scegliere un'opzione dalla casella combinata. Il testo è simile a quello delle informazioni presentate in una descrizione comando. Ad esempio, "Selezionare un'opzione per impostare la risoluzione dello schermo". |
| IsContentElementProperty | Vero | I controlli Casella combinata vengono sempre inclusi nella visualizzazione contenuto dell'albero di UI Automation. |
| IsControlElementProperty | Vero | I controlli Casella combinata vengono sempre inclusi nella visualizzazione controllo dell'albero di UI Automation. |
| IsKeyboardFocusableProperty | Vero | I controlli casella combinata espongono un set di elementi da un contenitore di selezione. Il controllo casella combinata può ricevere lo stato attivo, anche se, quando un client di automazione interfaccia utente imposta lo stato attivo su una casella combinata, tutti gli elementi nel sottoalbero della casella combinata possono ricevere lo stato attivo. |
| LabeledByProperty | Vedere le note. | I controlli casella combinata in genere includono un'etichetta di testo statico a cui questa proprietà fa riferimento. |
| LocalizedControlTypeProperty | "combo box" | Stringa localizzata corrispondente al tipo di controllo ComboBox. |
| NameProperty | Vedere le note. | Il controllo casella combinata in genere ricava il proprio nome da un controllo di testo statico. |
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 casella combinata. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IExpandCollapseProvider | Sì | Il controllo casella combinata, per essere tale, deve sempre contenere il pulsante a discesa. |
| ISelectionProvider | Sì | Visualizza la selezione corrente nella casella combinata. Questo supporto viene delegato alla casella di riepilogo sotto la casella combinata. |
| IValueProvider | Dipende da | Se la casella combinata può accettare valori di testo arbitrari, il pattern Value deve essere supportato. Questo pattern consente di impostare a livello di codice i contenuti delle stringhe della casella combinata. Se il pattern Value non è supportato, significa che l'utente deve effettuare una selezione tra gli elementi elenco nel sottoalbero della casella combinata. |
| IScrollProvider | Mai | Il pattern Scroll non è mai direttamente supportato in una casella combinata. È supportato se è possibile scorrere una casella di riepilogo contenuta in una casella combinata. Può essere supportato solo quando la casella di riepilogo è visibile sullo schermo. |
Eventi obbligatori
La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli casella combinata. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di UI Automation | Supporto tecnico | Note |
|---|---|---|
| AutomationFocusChangedEvent | Richiesto | 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 |
| StructureChangedEvent | Richiesto | None |
| Evento di modifica della proprietàExpandCollapseStateProperty . | Richiesto | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | Se il controllo supporta il pattern Value, deve supportare questo evento. |