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 |
|
Vedi anche
-
Riferimento