CB_INITSTORAGE

[Questo è documentazione preliminare e soggetto a cambiare].

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

CB_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.
cb
Specifica la quantità di memoria allocata per stringhe di elemento, in byte.

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

Se il messaggio non riesce, il valore restituito è CB_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 CB_INITSTORAGE aiuta a velocizzare l'inizializzazione di caselle combinate che dispongono di un numero elevato di elementi (oltre 100). Essa si riserva la quantità di memoria specificata, affinché i messaggi successivi, CB_ADDSTRING, CB_INSERTSTRING e CB_DIR 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 5.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

Combo Boxes Overview, Combo Box messaggi, CB_ADDSTRING, CB_DIR, CB_INSERTSTRING

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

Index