CB_ADDSTRING messaggio

  • Articolo

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.

Parametri

wParam

Questo parametro non viene usato.

lParam

Puntatore LPCTSTR alla stringa con terminazione Null da aggiungere. Se si crea la casella combinata con uno stile disegnato dal proprietario, ma senza lo stile CBS_HASSTRINGS , il valore del parametro lParam viene archiviato come dati dell'elemento anziché la stringa a cui punta altrimenti. I dati dell'elemento possono essere recuperati o modificati inviando il messaggio CB_GETITEMDATA o CB_SETITEMDATA .

Valore restituito

Il valore restituito è l'indice in base zero alla stringa nella casella di riepilogo della casella combinata. Se si verifica un errore, il valore restituito è CB_ERR. Se lo spazio insufficiente è disponibile per archiviare la nuova stringa, è CB_ERRSPACE.

Commenti

Se si crea una casella combinata disegnata dal proprietario con lo stile CBS_SORT ma senza lo stile CBS_HASSTRINGS, il messaggio di WM_COMPAREITEM viene inviato uno o più volte al proprietario della casella combinata in modo che il nuovo elemento possa essere inserito correttamente nell'elenco.

Per inserire una stringa in una posizione specifica all'interno dell'elenco, usare il messaggio CB_INSERTSTRING .

Se la casella combinata ha WS_HSCROLL stile e si aggiunge una stringa più ampia della casella combinata, inviare un messaggio LB_SETHORIZONTALEXTENT per assicurarsi che venga visualizzata la barra di scorrimento orizzontale.

Comclt32.dll versione 5.0 o successiva: Se CBS_LOWERCASE o CBS_UPPERCASE è impostata, la versione Unicode di CB_ADDSTRING modifica la stringa. Se si usa memoria globale di sola lettura, l'applicazione ha esito negativo.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Winuser.h (include Windows.h)

Vedi anche

Riferimento

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM