Tipo di controllo ComboBox

  • Articolo

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

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
  • ComboBox
    • Edit (0 o 1)
    • Elenco (0 o 1)
    • List Item (elemento figlio di List; da 0 a molti)
    • Button (1)
  • ComboBox
    • List Item (da 0 a molti)

 

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.

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente