messaggio LB_ADDSTRING

Aggiunge una stringa a una casella di riepilogo. Se la casella di riepilogo non ha lo stile LBS_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 alla stringa con terminazione Null da aggiungere.

Se la casella di riepilogo ha uno stile disegnato dal proprietario ma non lo stile LBS_HASSTRINGS , questo parametro viene archiviato come dati dell'elemento anziché come stringa. È possibile inviare i messaggi LB_GETITEMDATA e LB_SETITEMDATA per recuperare o modificare i dati dell'elemento.

Valore restituito

Il valore restituito è l'indice in base zero della stringa nella casella di riepilogo. Se si verifica un errore, il valore restituito viene LB_ERR. Se non è presente spazio sufficiente per archiviare la nuova stringa, il valore restituito è LB_ERRSPACE.

Commenti

Se la casella di riepilogo ha uno stile disegnato dal proprietario e lo stile LBS_SORT , ma non lo stile LBS_HASSTRINGS , il sistema invia il messaggio di WM_COMPAREITEM una o più volte al proprietario della casella di riepilogo per posizionare correttamente il nuovo elemento nella casella di riepilogo.

Il messaggio LB_INITSTORAGE consente di velocizzare l'inizializzazione delle caselle di riepilogo con un numero elevato di elementi (più di 100). Riserva la quantità di memoria specificata in modo che i messaggi successivi LB_ADDSTRING impiegano il più breve tempo possibile. È possibile usare stime per i parametri wParam e lParam . Se si sovrastima, la memoria aggiuntiva viene allocata; se si sottovaluta, l'allocazione normale viene usata per gli elementi che superano l'importo richiesto.

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

Per un'applicazione ANSI, il sistema converte il testo in una casella di riepilogo in Unicode usando CP_ACP. Ciò può causare problemi. Ad esempio, i caratteri romani accentati in una casella di riepilogo non Unicode in Windows giapponese verranno visualizzati in modo accentato. Per risolvere il problema, compilare l'applicazione come Unicode o usare una casella di riepilogo disegnata dal proprietario.

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

LB_DELETESTRING

LB_INSERTSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM