winuser.h

Mensaje CB_INITSTORAGE

Definición

CB_INITSTORAGE  
wParam = (WPARAM) (int) cItems;  // número de ítems a añadir
lParam = (LPARAM) (DWORD) cb;    // cantidad de memoria a asignar, en bytes

Una aplicación envía el mensaje CB_INITSTORAGE antes de añadir una gran cantidad de ítems al list box de un combo box. Este mensaje reserva memoria para almacenar los ítems del list box.

Descripción

cItems: especifica el número de ítems a añadir.

cb: especifica la cantidad de memoria a asignar para las cadenas de los ítems, en bytes.

Valor de retorno

Si el mensaje tiene éxito, el valor de retorno es el número máximo de ítems que el objeto de memoria puede almacenar.

Si el mensaje falla, el valor de retorno es CB_ERR.

Observaciones

Windows 95: este mensaje ayuda a mejorar la velocidad en la inicialización de combo boxes que tengan un gran número de ítems (más de 100). Reserva la cantidad de memoria especificada de modo que los subsiguientes mensajes CB_ADDSTRING, CB_INSERTSTRING y CB_DIR tomen el tiempo más corto posible. Se pueden usar valores estimativos para los parámetros cItems y cb. Si se sobrestima, la memoria extra queda reservada, si se subestima, se usa la forma normal para los ítems que excedan la cantidad pedida.

Windows NT: este mensaje no es necesario en Windows NT. No reserva la cantidad de memoria especificada, ya que la memoria disponible es virtualmente ilimitada. El valor de retorno es siempre el valor especificado en el parámetro cItems.