LB_INITSTORAGE

Un'applicazione invia il messaggio LB_INITSTORAGE prima di aggiungere un numero elevato di elementi a una casella di riepilogo. Questo messaggio alloca memoria per l'archiviazione di voci casella di riepilogo.

LB_INITSTORAGE wParam = cItems (WPARAM) (int);  / / numero di elementi da aggiungere lParam = cb (LPARAM) (DWORD);   / / quantità di memoria per allocare, in byte 
 

Parametri

cItems
Specifica il numero di elementi da aggiungere.

Windows 95 e Windows 98: Il parametro wParam è limitato a valori a 16 bit. Questo significa caselle di riepilogo non possono contenere più di 32.767 elementi. Anche se il numero di elementi è limitato, la dimensione totale in byte gli elementi in una casella di riepilogo è limitata solo dalla memoria disponibile.

cb
Specifica la quantità di memoria, in byte, di stanziare per stringhe di elemento.

Valori restituiti

Se il messaggio viene eseguita correttamente, il valore restituito è il numero totale di elementi per cui memoria è stato preassegnato, cioè, il numero totale di elementi aggiunti da tutti i messaggi di successo LB_INITSTORAGE.

Se il messaggio non riesce, il valore restituito è LB_ERRSPACE.

Windows NT: Per Windows NT versione 4.0, questo messaggio non alloca la quantità specificata di memoria; Tuttavia, restituisce sempre il valore specificato nel parametro cItems . Per Windows NT versione 5.0, il messaggio alloca la memoria e restituisce i valori di successo e l'errore descritti sopra.

Osservazioni

Il messaggio LB_INITSTORAGE aiuta a velocizzare l'inizializzazione di caselle di riepilogo che dispongono di un numero elevato di elementi (più di 100). Essa si riserva la quantità di memoria specificata, affinché i messaggi successivi, LB_ADDSTRING, LB_INSERTSTRING, LB_DIR e LB_ADDFILE prendono il minor tempo possibile. È possibile utilizzare le stime dei parametri cItems e cb . Se una sovrastima, viene allocata la memoria aggiuntiva; Se sottovalutano, la dotazione normale viene utilizzata per gli articoli che superano l'importo richiesto.

Descrizione

nbsp; Windows &NT: richiede una versione 4.0 o successive.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarata in winuser.

Vedi anche

Elenco caselle panoramica, elenco casella messaggi, LB_ADDFILE, LB_ADDSTRING, LB_DIR, LB_INSERTSTRING

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index