LB_INITSTORAGE

Um aplicativo envia a mensagem LB_INITSTORAGE antes de adicionar um grande número de itens a uma caixa de listagem. Esta mensagem aloca memória para armazenar itens de caixa de lista.

LB_INITSTORAGE wParam = cItems (WPARAM) (int);  / / número de itens para adicionar lParam = cb (LPARAM) (DWORD);   / / o montante de memória para alocar, em bytes 

 

Parâmetros

cItems
Especifica o número de itens para adicionar.

Windows 95 e Windows 98: O wParam parâmetro é limitado a 16-bit valores. Isso significa que as caixas de listagem não podem conter mais de 32.767 itens. Embora o número de itens é restrito, o tamanho total em bytes dos itens em uma caixa de listagem é limitado apenas pela memória disponível.

cb
Especifica a quantidade de memória, em bytes, alocar para seqüências de caracteres de item.

Retornar valores

Se a mensagem é bem-sucedido, o valor de retorno é o número total de itens para o qual memória tem sido pré-afectados, isto é, o número total de itens adicionados por todas as mensagens LB_INITSTORAGE bem sucedidas.

Se a mensagem falhar, o valor de retorno é LB_ERRSPACE.

Windows NT: Para o Windows NT versão 4.0, essa mensagem não alocar a quantidade especificada de memória; no entanto, ele sempre retorna o valor especificado no parâmetro cItems . Para o Windows NT versão 5.0, a mensagem aloca memória e retorna os valores de erro ou êxito descritos acima.

Observações

A mensagem LB_INITSTORAGE ajuda a acelerar a inicialização das caixas de listagem que tem um grande número de itens (mais de 100). Reserva-se a quantidade especificada de memória para que subseqüentes LB_ADDSTRING, LB_INSERTSTRING, LB_DIR e LB_ADDFILE mensagens levar o menor tempo possível. Você pode usar estimativas para a cItems e cb parâmetros. Se você overestimate, a memória adicional é alocada; Se você subestime, a alocação normal é usada para itens que excedam a quantidade solicitada.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de lista, caixa de listagem mensagens, LB_ADDFILE, LB_ADDSTRING, LB_DIR, LB_INSERTSTRING

Index