LB_INITSTORAGE mensagem

Aloca memória para armazenar itens de caixa de listagem. Essa mensagem pode ser usada antes que um aplicativo adicione um grande número de itens a uma caixa de listagem.

Parâmetros

wParam

O número de itens para os quais reservar espaço.

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

lParam

A quantidade de memória adicional, em bytes, a ser alocada para cadeias de caracteres de item.

Valor de retorno

Se a mensagem for bem-sucedida, o valor retornado será o número total de itens que a caixa de listagem pode armazenar antes que uma realocação de memória seja necessária.

Se a mensagem falhar, o valor retornado será LB_ERRSPACE.

Microsoft Windows NT 4.0: esta mensagem não aloca a quantidade de memória especificada; no entanto, ele sempre retorna o valor especificado no parâmetro wParam .

Observações

A mensagem LB_INITSTORAGE ajuda a acelerar a inicialização das caixas de listagem que têm um grande número de itens (mais de 100). Ele reserva a quantidade de memória especificada para que as mensagens LB_ADDSTRING, LB_INSERTSTRING, LB_DIR e LB_ADDFILE subsequentes sejam mais eficientes. Você pode usar estimativas para os parâmetros wParam e lParam . Se você superestimar, a memória extra permanecerá alocada; se você subestimar, a caixa de listagem alocará memória adicional conforme necessário.

A memória necessária para armazenar uma cadeia de caracteres inclui o terminador nulo. Portanto, se você planeja adicionar 100 cadeias de caracteres, cada uma com um comprimento de 10 caracteres, você passará um wParam de 100 e um lParam de 100 × (10 + 1) × sizeof(TCHAR).

Requirements

Consulte também

Referência

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING