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 |
|