Casella combinata (controlli Windows)

  • Articolo

Questa sezione contiene informazioni sugli elementi di programmazione usati con le caselle combinate. Una casella combinata è un tipo univoco di controllo, definito dalla classe COMBOBOX, che combina gran parte delle funzionalità di una casella di riepilogo e di un controllo di modifica.

Panoramiche

Argomento Contenuto
Informazioni sulle caselle combinate In questa sezione vengono illustrati i diversi tipi di caselle combinate.
Funzionalità casella combinata Questo documento illustra le caratteristiche della casella combinata.
Uso di caselle combinate Gli esempi di codice in questa sezione illustrano come eseguire attività associate alle caselle combinate.

Funzioni

Argomento Contenuto
DlgDirListComboBox Sostituisce il contenuto di una casella combinata con i nomi delle sottodirectory e dei file in una directory specificata. È possibile filtrare l'elenco dei nomi specificando un set di attributi di file. L'elenco dei nomi può includere lettere di unità mappate.
DlgDirSelectComboBoxEx Recupera la selezione corrente da una casella combinata riempita utilizzando la funzione DlgDirListComboBox. La selezione viene interpretata come lettera di unità, un file o un nome di directory.
GetComboBoxInfo Recupera informazioni sulla casella combinata specificata.

Macro

Argomento Contenuto
ComboBox_AddItemData Aggiunge i dati degli elementi all'elenco in una casella combinata nella posizione specificata. È possibile utilizzare questa macro o inviare il messaggio di CB_ADDSTRING in modo esplicito.
ComboBox_AddString Aggiunge una stringa a un elenco in una casella combinata. Se la casella combinata non ha lo stile CBS_SORT , la stringa viene aggiunta alla fine dell'elenco. In caso contrario, la stringa viene inserita nell'elenco e l'elenco viene ordinato. È possibile utilizzare questa macro o inviare il messaggio di CB_ADDSTRING in modo esplicito.
ComboBox_DeleteString Elimina l'elemento nella posizione specificata in un elenco in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_DELETESTRING in modo esplicito.
ComboBox_Dir Aggiunge nomi all'elenco visualizzato da una casella combinata. La macro aggiunge i nomi di directory e file che corrispondono a una stringa e a un set di attributi di file specificati. Può anche aggiungere lettere di unità mappate all'elenco in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_DIR in modo esplicito.
ComboBox_Enable Abilita o disabilita un controllo casella combinata.
ComboBox_FindItemData Trova il primo elemento in un elenco di caselle combinate con i dati dell'elemento specificati. È possibile utilizzare questa macro o inviare il messaggio di CB_FINDSTRING in modo esplicito.
ComboBox_FindString Trova la prima stringa in un elenco di caselle combinate che inizia con la stringa specificata. È possibile utilizzare questa macro o inviare il messaggio di CB_FINDSTRING in modo esplicito.
ComboBox_FindStringExact Trova la prima stringa in un elenco di caselle combinate che corrisponde esattamente alla stringa specificata, ad eccezione del fatto che la ricerca non fa distinzione tra maiuscole e minuscole. È possibile utilizzare questa macro o inviare il messaggio di CB_FINDSTRINGEXACT in modo esplicito.
ComboBox_GetCount Ottiene il numero di elementi nella casella di riepilogo di una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_GETCOUNT in modo esplicito.
ComboBox_GetCueBannerText Ottiene il testo del banner segnale visualizzato nel controllo di modifica di una casella combinata. Utilizzare questa macro o inviare il messaggio di CB_GETCUEBANNER in modo esplicito.
ComboBox_GetCurSel Ottiene l'indice dell'elemento attualmente selezionato in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio CB_GETCURedizione Standard L in modo esplicito.
ComboBox_GetDroppedControlRect Recupera le coordinate dello schermo di una casella combinata nello stato di eliminazione. È possibile utilizzare questa macro o inviare il messaggio di CB_GETDROPPEDCONTROLRECT in modo esplicito.
ComboBox_GetDroppedState Verifica se l'elenco a discesa in un controllo casella combinata è visibile. È possibile utilizzare questa macro o inviare il messaggio di CB_GETDROPPEDSTATE in modo esplicito.
ComboBox_GetExtendedUI Verifica se una casella combinata usa l'interfaccia utente predefinita o l'interfaccia utente estesa. È possibile utilizzare questa macro o inviare il messaggio di CB_GETEXTENDEDUI in modo esplicito.
ComboBox_GetItemData Ottiene il valore definito dall'applicazione associato all'elemento di elenco specificato in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_GETITEMDATA in modo esplicito.
ComboBox_GetItemHeight Recupera l'altezza delle voci di elenco in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_GETITEMHEIGHT in modo esplicito.
ComboBox_GetLBText Ottiene una stringa da un elenco in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_GETLBTEXT in modo esplicito.
ComboBox_GetLBTextLen Ottiene la lunghezza di una stringa nell'elenco in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_GETLBTEXTLEN in modo esplicito.
ComboBox_GetMinVisible Ottiene il numero minimo di elementi visibili nell'elenco a discesa di una casella combinata.
ComboBox_GetText Recupera il testo da un controllo casella combinata.
ComboBox_GetTextLength Ottiene il numero di caratteri nel testo di una casella combinata.
ComboBox_InsertItemData Inserisce i dati degli elementi in un elenco in una casella combinata nella posizione specificata. È possibile utilizzare questa macro o inviare il messaggio CB_INedizione Standard RTSTRING in modo esplicito.
ComboBox_InsertString Aggiunge una stringa a un elenco in una casella combinata nella posizione specificata. È possibile utilizzare questa macro o inviare il messaggio CB_INedizione Standard RTSTRING in modo esplicito.
ComboBox_LimitText Limita la lunghezza del testo che l'utente può digitare nel controllo di modifica di una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_LIMITTEXT in modo esplicito.
ComboBox_ResetContent Rimuove tutti gli elementi dalla casella di riepilogo e il controllo di modifica di una casella combinata. È possibile utilizzare questa macro o inviare il messaggio CB_REedizione Standard TCONTENT in modo esplicito.
ComboBox_SelectItemData Cerca un elenco in una casella combinata per un elemento con i dati dell'elemento specificati. Se viene trovato un elemento corrispondente, l'elemento viene selezionato. È possibile utilizzare questa macro o inviare il messaggio CB_edizione Standard LECTSTRING in modo esplicito.
ComboBox_SelectString Cerca un elenco in una casella combinata per un elemento che inizia con i caratteri in una stringa specificata. Se viene trovato un elemento corrispondente, l'elemento viene selezionato. È possibile utilizzare questa macro o inviare il messaggio CB_edizione Standard LECTSTRING in modo esplicito.
ComboBox_SetCueBannerText Imposta il testo del banner segnale visualizzato per il controllo di modifica di una casella combinata.
ComboBox_SetCurSel Imposta l'elemento attualmente selezionato in una casella combinata. È possibile usare questa macro o inviare il messaggio CB_edizione Standard TCUR edizione Standard L in modo esplicito.
ComboBox_SetExtendedUI Seleziona l'interfaccia utente predefinita o l'interfaccia utente estesa per una casella combinata con lo stile CBS_DROPDOWN o CBS_DROPDOWNLIST. È possibile utilizzare questa macro o inviare il messaggio CB_edizione Standard TEXTENDEDUI in modo esplicito.
ComboBox_SetItemData Imposta il valore definito dall'applicazione associato all'elemento di elenco specificato in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio CB_edizione Standard TITEMDATA in modo esplicito.
ComboBox_SetItemHeight Imposta l'altezza degli elementi dell'elenco o del campo di selezione in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio CB_edizione Standard TITEMHEIGHT in modo esplicito.
ComboBox_SetMinVisible Imposta il numero minimo di elementi visibili nell'elenco a discesa di una casella combinata.
ComboBox_SetText Imposta il testo di una casella combinata.
ComboBox_ShowDropdown Visualizza o nasconde l'elenco in una casella combinata. È possibile utilizzare questa macro o inviare il messaggio di CB_SHOWDROPDOWN in modo esplicito.

Messaggi

Argomento Contenuto
CB_ADDSTRING Aggiunge una stringa alla casella di riepilogo di una casella combinata. Se la casella combinata non ha lo stile CBS_SORT , la stringa viene aggiunta alla fine dell'elenco. In caso contrario, la stringa viene inserita nell'elenco e l'elenco viene ordinato.
CB_DELETESTRING Elimina una stringa nella casella di riepilogo di una casella combinata.
CB_DIR Aggiunge nomi all'elenco visualizzato dalla casella combinata. Il messaggio aggiunge i nomi di directory e file che corrispondono a una stringa e a un set di attributi di file specificati. CB_DIR può anche aggiungere lettere di unità mappate all'elenco.
CB_FINDSTRING Cerca nella casella di riepilogo di una casella combinata un elemento che inizia con i caratteri in una stringa specificata.
CB_FINDSTRINGEXACT Trova la prima stringa della casella di riepilogo in una casella combinata corrispondente alla stringa specificata nel parametro lParam .
CB_GETCOMBOBOXINFO Ottiene informazioni sulla casella combinata specificata.
CB_GETCOUNT Ottiene il numero di elementi nella casella di riepilogo di una casella combinata.
CB_GETCUEBANNER Ottiene il testo del banner segnale visualizzato nel controllo di modifica di una casella combinata. Inviare questo messaggio in modo esplicito o utilizzando la macro ComboBox_GetCueBannerText.
CB_GETCURedizione Standard L Un'applicazione invia un messaggio CB_GETCURedizione Standard L per recuperare l'indice dell'elemento attualmente selezionato, se presente, nella casella di riepilogo di una casella combinata.
CB_GETDROPPEDCONTROLRECT Un'applicazione invia un messaggio CB_GETDROPPEDCONTROLRECT per recuperare le coordinate dello schermo di una casella combinata nello stato di eliminazione.
CB_GETDROPPEDSTATE Determina se la casella di riepilogo di una casella combinata viene eliminata.
CB_GETDROPPEDWIDTH Ottiene la larghezza minima consentita, in pixel, della casella di riepilogo di una casella combinata con lo stile CBS_DROPDOWN o CBS_DROPDOWNLIST.
CB_GETEDITedizione Standard L Ottiene le posizioni del carattere iniziale e finale della selezione corrente nel controllo di modifica di una casella combinata.
CB_GETEXTENDEDUI Determina se una casella combinata ha l'interfaccia utente predefinita o l'interfaccia utente estesa.
CB_GETHORIZONTALEXTENT Ottiene la larghezza, espressa in pixel, di cui è possibile scorrere orizzontalmente la casella di riepilogo (larghezza scorrevole). Questa opzione è applicabile solo se la casella di riepilogo ha una barra di scorrimento orizzontale.
CB_GETITEMDATA Un'applicazione invia un messaggio CB_GETITEMDATA a una casella combinata per recuperare il valore fornito dall'applicazione associato all'elemento specificato nella casella combinata.
CB_GETITEMHEIGHT Determina l'altezza degli elementi dell'elenco o del campo di selezione in una casella combinata.
CB_GETLBTEXT Ottiene una stringa dall'elenco di una casella combinata.
CB_GETLBTEXTLEN Ottiene la lunghezza, in caratteri, di una stringa nell'elenco di una casella combinata.
CB_GETLOCALE Ottiene le impostazioni locali correnti della casella combinata. Le impostazioni locali vengono utilizzate per determinare l'ordinamento corretto del testo visualizzato per le caselle combinate con lo stile e il testo CBS_SORT aggiunti utilizzando il messaggio di CB_ADDSTRING.
CB_GETMINVISIBLE Ottiene il numero minimo di elementi visibili nell'elenco a discesa di una casella combinata.
CB_GETTOPINDEX Un'applicazione invia il messaggio di CB_GETTOPINDEX per recuperare l'indice in base zero del primo elemento visibile nella parte casella di riepilogo di una casella combinata. Inizialmente, l'elemento con indice 0 si trova nella parte superiore della casella di riepilogo, ma se il contenuto della casella di riepilogo è stato scorrevole, un altro elemento potrebbe trovarsi nella parte superiore.
CB_INITSTORAGE Un'applicazione invia il messaggio CB_INITSTORAGE prima di aggiungere un numero elevato di elementi alla parte casella di riepilogo di una casella combinata. Questo messaggio alloca memoria per l'archiviazione degli elementi della casella di riepilogo.
CB_INedizione Standard RTSTRING Inserisce dati stringa o elemento nell'elenco di una casella combinata. A differenza del messaggio CB_ADDSTRING, il messaggio CB_INedizione Standard RTSTRING non determina l'ordinamento di un elenco con lo stile CBS_SORT.
CB_LIMITTEXT Limita la lunghezza del testo che l'utente può digitare nel controllo di modifica di una casella combinata.
CB_REedizione Standard TCONTENT Rimuove tutti gli elementi dalla casella di riepilogo e il controllo di modifica di una casella combinata.
CB_edizione Standard LECTSTRING Cerca nell'elenco di una casella combinata un elemento che inizia con i caratteri in una stringa specificata. Se viene trovato un elemento corrispondente, viene selezionato e copiato nel controllo di modifica.
CB_edizione Standard TCUEBANNER Imposta il testo del banner segnale visualizzato per il controllo di modifica di una casella combinata.
CB_edizione Standard TCUR edizione Standard L Un'applicazione invia un messaggio CB_edizione Standard TCUR edizione Standard L per selezionare una stringa nell'elenco di una casella combinata. Se necessario, l'elenco scorre la stringa nella visualizzazione. Il testo nel controllo di modifica della casella combinata cambia in modo da riflettere la nuova selezione e qualsiasi selezione precedente nell'elenco viene rimossa.
CB_edizione Standard TDROPPEDWIDTH Un'applicazione invia il messaggio CB_edizione Standard TDROPPEDWIDTH per impostare la larghezza massima consentita, in pixel, della casella di riepilogo di una casella combinata con lo stile CBS_DROPDOWN o CBS_DROPDOWNLIST.
CB_edizione Standard TEDIT edizione Standard L Un'applicazione invia un messaggio CB_edizione Standard TEDIT edizione Standard L per selezionare i caratteri nel controllo di modifica di una casella combinata.
CB_edizione Standard TEXTENDEDUI Un'applicazione invia un messaggio CB_edizione Standard TEXTENDEDUI per selezionare l'interfaccia utente predefinita o l'interfaccia utente estesa per una casella combinata con lo stile CBS_DROPDOWN o CBS_DROPDOWNLIST.
CB_edizione Standard THORIZONTALEXTENT Un'applicazione invia il messaggio CB_edizione Standard THORIZONTALEXTENT per impostare la larghezza, in pixel, in cui è possibile scorrere orizzontalmente una casella di riepilogo (larghezza scorrevole). Se la larghezza della casella di riepilogo è inferiore a questo valore, la barra di scorrimento orizzontale scorre orizzontalmente gli elementi nella casella di riepilogo. Se la larghezza della casella di riepilogo è uguale o maggiore di questo valore, la barra di scorrimento orizzontale è nascosta o, se la casella combinata ha lo stile CBS_DISABLENOSCROLL , disabilitato.
CB_edizione Standard TITEMDATA Un'applicazione invia un messaggio CB_edizione Standard TITEMDATA per impostare il valore associato all'elemento specificato in una casella combinata.
CB_edizione Standard TITEMHEIGHT Un'applicazione invia un messaggio CB_edizione Standard TITEMHEIGHT per impostare l'altezza degli elementi dell'elenco o il campo di selezione in una casella combinata.
CB_edizione Standard TLOCALE Un'applicazione invia un messaggio CB_edizione Standard TLOCALE per impostare le impostazioni locali correnti della casella combinata. Se la casella combinata ha lo stile e le stringhe CBS_SORT vengono aggiunte utilizzando CB_ADDSTRING, le impostazioni locali di una casella combinata influiscono sulla modalità di ordinamento degli elementi dell'elenco.
CB_edizione Standard TMINVISIBLE Un'applicazione invia un messaggio CB_edizione Standard TMINVISIBLE per impostare il numero minimo di elementi visibili nell'elenco a discesa di una casella combinata.
CB_edizione Standard TTOPINDEX Un'applicazione invia il messaggio CB_edizione Standard TTOPINDEX per assicurarsi che un particolare elemento sia visibile nella casella di riepilogo di una casella combinata. Il sistema scorre il contenuto della casella di riepilogo in modo che l'elemento specificato venga visualizzato nella parte superiore della casella di riepilogo o che sia stato raggiunto l'intervallo di scorrimento massimo.
CB_SHOWDROPDOWN Un'applicazione invia un messaggio di CB_SHOWDROPDOWN per visualizzare o nascondere la casella di riepilogo di una casella combinata con lo stile CBS_DROPDOWN o CBS_DROPDOWNLIST.

Notifications

Argomento Contenuto
CBN_CLOedizione Standard UP Il codice di notifica CBN_CLOedizione Standard UP viene inviato quando la casella di riepilogo di una casella combinata è stata chiusa. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_DBLCLK Il codice di notifica CBN_DBLCLK viene inviato quando l'utente fa doppio clic su una stringa nella casella di riepilogo di una casella combinata. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_DROPDOWN Il codice di notifica CBN_DROPDOWN viene inviato quando la casella di riepilogo di una casella combinata sta per essere resa visibile. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_EDITCHANGE Il codice di notifica CBN_EDITCHANGE viene inviato dopo che l'utente ha eseguito un'azione che potrebbe aver modificato il testo nella parte del controllo di modifica di una casella combinata. A differenza del codice di notifica CBN_EDITUPDATE , questo codice di notifica viene inviato dopo che il sistema aggiorna la schermata. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_EDITUPDATE Il codice di notifica CBN_EDITUPDATE viene inviato quando la parte di controllo di modifica di una casella combinata sta per visualizzare testo modificato. Questo codice di notifica viene inviato dopo che il controllo ha formattato il testo, ma prima di visualizzare il testo. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_ERRSPACE Il codice di notifica CBN_ERRSPACE viene inviato quando una casella combinata non può allocare memoria sufficiente per soddisfare una richiesta specifica. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_KILLFOCUS Il codice di notifica CBN_KILLFOCUS viene inviato quando una casella combinata perde lo stato attivo della tastiera. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_edizione Standard LCHANGE Il codice di notifica CBN_edizione Standard LCHANGE viene inviato quando l'utente modifica la selezione corrente nella casella di riepilogo di una casella combinata. L'utente può modificare la selezione facendo clic nella casella di riepilogo o usando i tasti di direzione. La finestra padre della casella combinata riceve questa notifica sotto forma di messaggio di WM_COMMAND con CBN_edizione Standard LCHANGE nella parola ad ordine elevato del parametro wParam.
CBN_edizione Standard LENDCANCEL Il codice di notifica CBN_edizione Standard LENDCANCEL viene inviato quando l'utente seleziona un elemento, ma seleziona un altro controllo o chiude la finestra di dialogo. Indica che la selezione iniziale dell'utente deve essere ignorata. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_edizione Standard LENDOK Il codice di notifica CBN_edizione Standard LENDOK viene inviato quando l'utente seleziona una voce di elenco oppure seleziona un elemento e quindi chiude l'elenco. Indica che la selezione dell'utente deve essere elaborata. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
CBN_edizione Standard TFOCUS Il codice di notifica CBN_edizione Standard TFOCUS viene inviato quando una casella combinata riceve lo stato attivo della tastiera. La finestra padre della casella combinata riceve questo codice di notifica tramite il messaggio di WM_COMMAND.
WM_COMPAREITEM Il sistema invia il messaggio di WM_COMPAREITEM per determinare la posizione relativa di un nuovo elemento nell'elenco ordinato di una casella combinata o di una casella di riepilogo disegnata dal proprietario. Ogni volta che l'applicazione aggiunge un nuovo elemento, il sistema invia il messaggio al proprietario di una casella combinata o di una casella di riepilogo creata con lo stile CBS_SORT o LBS_SORT.
WM_DRAWITEM Il messaggio WM_DRAWITEM viene inviato alla finestra padre di un pulsante disegnato dal proprietario, di una casella combinata, di una casella di riepilogo o di un menu quando un aspetto visivo del pulsante, della casella combinata, della casella di riepilogo o del menu è stato modificato.
WM_MEASUREITEM Il messaggio WM_MEASUREITEM viene inviato alla finestra proprietario di una casella combinata, di una casella di riepilogo, di un controllo visualizzazione elenco o di una voce di menu quando viene creato il controllo o il menu.

Strutture

Argomento Contenuto
COMBOBOXINFO Contiene informazioni sullo stato della casella combinata.
COMPAREITEMSTRUCT Fornisce gli identificatori e i dati forniti dall'applicazione per due elementi in una casella di riepilogo ordinata, disegnata dal proprietario o in una casella combinata.
DRAWITEMSTRUCT Fornisce le informazioni necessarie alla finestra del proprietario per determinare come disegnare un controllo o una voce di menu disegnata dal proprietario. La finestra proprietario del controllo o della voce di menu disegnata dal proprietario riceve un puntatore a questa struttura come parametro lParam del messaggio WM_DRAWITEM .
MEASUREITEMSTRUCT Informa il sistema delle dimensioni di un controllo o di una voce di menu disegnata dal proprietario. In questo modo il sistema può elaborare correttamente l'interazione dell'utente con il controllo.

Costanti

Argomento Contenuto
Stili casella combinata Per creare una casella combinata usando la funzione CreateWindow o CreateWindowEx, specificare la classe COMBOBOX, le costanti di stile della finestra appropriate e una combinazione degli stili casella combinata seguenti.