mensaje de LB_INITSTORAGE

Asigna memoria para almacenar elementos de cuadro de lista. Este mensaje se puede usar antes de que una aplicación agregue un gran número de elementos a un cuadro de lista.

Parámetros

wParam

Número de elementos para los que se va a reservar espacio.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): el parámetro wParam está limitado a valores de 16 bits. Esto significa que los cuadros de lista no pueden contener más de 32 767 elementos. Aunque el número de elementos está restringido, el tamaño total de los elementos de un cuadro de lista solo está limitado por la memoria disponible.

lParam

Cantidad de memoria adicional, en bytes, que se va a asignar para las cadenas de elemento.

Valor devuelto

Si el mensaje se realiza correctamente, el valor devuelto es el número total de elementos que el cuadro de lista puede almacenar antes de que se necesite una reasignación de memoria.

Si se produce un error en el mensaje, se LB_ERRSPACE el valor devuelto.

Microsoft Windows NT 4.0: este mensaje no asigna la cantidad de memoria especificada; sin embargo, siempre devuelve el valor especificado en el parámetro wParam .

Observaciones

El LB_INITSTORAGE mensaje ayuda a acelerar la inicialización de cuadros de lista que tienen un gran número de elementos (más de 100). Reserva la cantidad de memoria especificada para que los mensajes de LB_ADDSTRING, LB_INSERTSTRING, LB_DIR y LB_ADDFILE sean más eficaces. Puede usar estimaciones para los parámetros wParam y lParam . Si se sobrestima, la memoria adicional permanece asignada; si subestima, el cuadro de lista asignará memoria adicional según sea necesario.

La memoria necesaria para almacenar una cadena incluye el terminador NULL. Por lo tanto, si planea agregar 100 cadenas, cada una con una longitud de 10 caracteres, pasaría un wParam de 100 y un lParam de 100 × (10 + 1) × sizeof(TCHAR).

Requisitos

Consulte también

Referencia

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING