Condividi tramite

Tipo di controllo ComboBox

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo comboBox.

Una casella combinata è una casella di riepilogo combinata con un controllo statico o un controllo di modifica che visualizza l'elemento attualmente selezionato nella parte casella di riepilogo della casella combinata. La parte casella di riepilogo del controllo viene visualizzata sempre o viene visualizzata solo quando l'utente seleziona la freccia a discesa (che è un pulsante di pressione) accanto al controllo. Se il campo di selezione è un controllo di modifica, l'utente può immettere informazioni che non si trovano nell'elenco; in caso contrario, l'utente può selezionare solo gli elementi nell'elenco.

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 ComboBox. I requisiti di automazione interfaccia utente si applicano a tutti i controlli casella combinata in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.

Questo argomento contiene le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli casella combinata e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Visualizzazione controlli Visualizzazione contenuto
  • ComboBox
    • Modifica (0 o 1)
    • Elenco (0 o 1)
    • Elemento elenco (figlio dell'elenco; da 0 a molti)
    • Pulsante (1)
  • ComboBox
    • Elemento elenco (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à di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per il tipo di controllo ComboBox. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.

Ui Automation, proprietà 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 di automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile.
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida per i controlli casella combinata deve spiegare perché viene chiesto all'utente di scegliere un'opzione dalla casella combinata. Il testo è simile alle informazioni presentate tramite una descrizione comando. Ad esempio, "Selezionare un elemento per impostare la risoluzione di visualizzazione del monitor".
UIA_IsContentElementPropertyId VERO I controlli casella combinata sono sempre inclusi nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO I controlli casella combinata sono sempre inclusi nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId VERO I controlli casella combinata possono ricevere lo stato attivo della tastiera; Tuttavia, quando un client di 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 hanno un'etichetta di testo statica a cui fa riferimento questa proprietà.
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à Nome. La proprietà Nome non deve mai contenere il contenuto corrente della casella combinata o modificare quando il contenuto della casella combinata cambia.

 

Modelli di controllo obbligatori

La tabella seguente elenca i pattern di controllo di 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.For more information on control patterns, see UI Automation Control Patterns Overview.

Pattern di controllo Appoggiare Note
IExpandCollapseProvider Obbligatorio Il ExpandCollapse pattern di controllo deve essere supportato perché un controllo casella combinata deve contenere sempre un pulsante a discesa.
ISelectionProvider Dipende Visualizza la selezione corrente nella casella combinata. Il supporto per Selezione pattern di controllo viene delegato alla casella di riepilogo sotto la casella combinata, ma potrebbe non essere sempre fattibile.
IValueProvider Dipende Se la casella combinata può accettare valori di testo arbitrario, è necessario supportare il pattern di controllo valore. Questo modello consente di impostare a livello di codice il contenuto della stringa della casella combinata. Se il pattern di controllo Valore non è supportato, l'utente deve selezionare gli elementi dell'elenco all'interno del sottoalbero della casella combinata.
IScrollProvider Mai Il pattern 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 di automazione interfaccia utente necessari per supportare i controlli casella combinata. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica delle proprietà.
UIA_IsEnabledPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento.
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId evento di modifica delle proprietà.
UIA_ValueValuePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Value, deve supportare questo evento.

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente