Compartilhar via


LVM_SETITEMCOUNT mensagem

Faz com que o controle de exibição de lista aloque memória para o número especificado de itens ou define o número virtual de itens em um controle de exibição de lista virtual.

Parâmetros

wParam

Número de itens que o controle de exibição de lista conterá.

lParam

Versão 4.70. Valores que especificam o comportamento do controle list-view depois de redefinir a contagem de itens. Esse valor pode ser uma combinação do seguinte:

Valor Significado
LVSICF_NOINVALIDATEALL
O controle de exibição de lista não será repintar, a menos que os itens afetados estejam atualmente em exibição.
LVSICF_NOSCROLL
O controle list-view não alterará a posição de rolagem quando a contagem de itens for alterada.

Valor retornado

Retorna diferente de zero se tiver êxito; caso contrário, zero.

Comentários

A forma como a memória é alocada depende de como o controle de exibição de lista foi criado. Você pode enviar essa mensagem explicitamente ou usar as macros ListView_SetItemCount ou ListView_SetItemCountEx . Para obter mais informações, consulte Estilo de List-View virtual.

Se o controle list-view tiver sido criado sem o estilo LVS_OWNERDATA , enviar essa mensagem fará com que o controle aloque suas estruturas de dados internas para o número especificado de itens. Isso impede que o controle precise alocar as estruturas de dados sempre que um item é adicionado.

Se o controle list-view tiver sido criado com o estilo LVS_OWNERDATA (uma exibição de lista virtual), enviar essa mensagem definirá o número virtual de itens que o controle contém.

O parâmetro lParam destina-se apenas a controles de exibição de lista que usam os estilos LVS_OWNERDATA e LVS_REPORT ou LVS_LIST .

Quando a exibição de lista de controle comum é uma exibição de lista virtualizada (LVS_OWNERDATA), há um limite de 100.000.000 itens no modo de exibição de lista. Nesse cenário, LVM_SETITEMCOUNT retornará FALSE quando tiver um wParam de 100.000.001.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h