Tipo di controllo ComboBox
Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo ComboBox.
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 sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo ComboBox. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli casella combinata in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Modelli di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli casella combinata e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Il controllo di modifica nella visualizzazione controllo della casella combinata è necessario solo se la casella combinata può essere modificata per accettare qualsiasi input, come nel caso della casella combinata nella finestra di dialogo Esegui .
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per il tipo di controllo ComboBox. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable. |
| UIA_ControlTypePropertyId | ComboBox | |
| UIA_HelpTextPropertyId | Vedere le note. | Il testo della Guida per i controlli casella combinata deve spiegare perché l'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". |
| UIA_IsContentElementPropertyId | TRUE | I controlli casella combinata sono sempre inclusi nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | I controlli casella combinata sono sempre inclusi nella visualizzazione controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | TRUE | I controlli casella combinata possono ricevere lo stato attivo della tastiera; Tuttavia, quando un client Automazione interfaccia utente imposta lo stato attivo su una casella combinata, qualsiasi elemento nel sottoalbero casella combinata può ricevere lo stato attivo. |
| UIA_LabeledByPropertyId | Vedere le note. | I controlli casella combinata in genere includono un'etichetta di testo statico a cui questa proprietà fa riferimento. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo ComboBox . Il valore predefinito è "casella combinata" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il nome del controllo casella combinata viene in genere generato da un'etichetta di testo statica. Se non è presente un'etichetta di testo statica, è necessario assegnare un valore per la proprietà Name . La proprietà Name non deve mai contenere il contenuto corrente della casella combinata o modificare quando il contenuto della casella combinata cambia. |
Modelli di controllo obbligatori
Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per 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 | Note |
|---|---|---|
| IExpandCollapseProvider | Necessario | Il modello di controllo ExpandCollapse deve essere supportato perché un controllo casella combinata deve sempre contenere un pulsante a discesa. |
| ISelectionProvider | Dipende da | Visualizza la selezione corrente nella casella combinata. Il supporto per il modello di controllo Selezione viene delegato alla casella di riepilogo sotto la casella combinata, ma potrebbe non essere sempre fattibile. |
| IValueProvider | Dipende da | Se la casella combinata può accettare valori di testo arbitrari, è necessario supportare il modello di controllo Valore . Questo modello consente di impostare a livello di codice il contenuto della stringa della casella combinata. Se il modello di controllo Valore non è supportato, l'utente deve selezionare gli elementi dell'elenco all'interno del sottoalbero della casella combinata. |
| IScrollProvider | Mai | Il modello di controllo Scroll non è mai supportato direttamente in una casella combinata. È supportato se una casella di riepilogo contenuta in una casella combinata può scorrere e solo quando la casella di riepilogo è visibile sullo schermo. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli casella combinata. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Automazione interfaccia utente evento | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento modificato dalla proprietà. | |
| UIA_IsEnabledPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento. |
| UIA_StructureChangedEventId | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId evento modificato dalla proprietà. | |
| UIA_ValueValuePropertyId evento modificato dalla proprietà. | Se il controllo supporta il modello di controllo Value , deve supportare questo evento. |
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente