messaggio LB_INSERTSTRING

Inserisce dati stringa o elemento in una casella di riepilogo. A differenza del messaggio LB_ADDSTRING , il messaggio LB_INSERTSTRING non causa l'ordinamento di un elenco con lo stile LBS_SORT .

Parametri

wParam

Indice in base zero della posizione in corrispondenza della quale inserire la stringa. Se questo parametro è -1, la stringa viene aggiunta alla fine dell'elenco.

lParam

Puntatore alla stringa con terminazione null da inserire. 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é una 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 della posizione in cui è stata inserita la stringa. Se si verifica un errore, il valore restituito è LB_ERR. Se non è disponibile spazio sufficiente per archiviare la nuova stringa, il valore restituito è LB_ERRSPACE.

Commenti

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_INSERTSTRING richiedono 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, la normale allocazione viene usata per gli elementi che superano l'importo richiesto.

Se la casella di riepilogo ha WS_HSCROLL stile e si inserisce 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 garbato. Per risolvere questo 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_ADDSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT