commctrl.h

Mensaje LVM_SETITEMCOUNT

Definición

LVM_SETITEMCOUNT
    cItems=(WPARAM)(int)wParam
    dwflags=(LPARAM)(DWORD)lParam

Hace que el control list-view obtenga memoria para el número especificado de ítems. Se puede enviar este mensaje explícitamente o bien usar la macro .

Descripción

cItems
El número de ítems para el que el control list-view debe obtener memoria.
dwflags
Versión 4.70. Valores que especifican el comportamiento del control list-view después de resetear el número de ítems. Este valor puede ser una combinación de los siguientes:

ValorSignificado
LVSICF_NOINVALIDATEALLEl control list-view no se repinta salvo que los ítems afectados estén actualmente en la vista.
LVSICF_NOSCROLLEl control list-view no cambia la posición del scroll cuando el número de ítems cambie.

Valor de retorno

Devuelve un valor distinto de cero si tiene éxito, o cero en caso contrario.

Observaciones

El modo en que se obtenga la memoria depende de como fue creado el control list-view. Se puede enviar este mensaje explícitamente o usar las macros ListView_SetItemCount o ListView_SetItemCountEx.

Si el control list-view fue creado sin el estilo LVS_OWNERDATA, esta macro hace que el control obtenga su estructura de datos interna para el número especificado de ítems. Esto evita que el control obtenga memoria para estructuras de datos cada vez que se añade un ítem.

Si el control list-view fue creado con el estilo LVS_OWNERDATA (list-view virtual), se debe usar la macro ListView_SetItemCountEx.

El parámetro lParam está pensado solo para controles list-view que usen los estilos LVS_OWNERDATA y LVS_REPORT o LVS_LIST.

Cuando el control común list-view es un list-view virtualizado (LVS_OWNERDATA), hay un límite de 100,000,000 de ítems en el list-view. En ese escenario, LVM_SETITEMCOUNT retornará FALSE cuando wParam sea 100,000,001.