Compartilhar via


CB_INITSTORAGE mensagem

Um aplicativo envia a mensagem CB_INITSTORAGE antes de adicionar um grande número de itens à parte da caixa de listagem de uma caixa de combinação. Esta mensagem aloca memória para armazenar itens de caixa de listagem.

Parâmetros

wParam

O número de itens a serem adicionados.

lParam

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

Valor retornado

Se a mensagem for bem-sucedida, o valor retornado será o número total de itens para os quais a memória foi pré-alocada, ou seja, o número total de itens adicionados por todas as mensagens de CB_INITSTORAGE bem-sucedidas.

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

A mensagem aloca memória e retorna os valores de êxito e erro descritos acima.

Comentários

A mensagem CB_INITSTORAGE ajuda a acelerar a inicialização de caixas de combinação que têm um grande número de itens (mais de 100). Ele reserva a quantidade de memória especificada para que as mensagens CB_ADDSTRING, CB_INSERTSTRING e CB_DIR subsequentes levem o menor tempo possível. Você pode usar estimativas para os parâmetros wParam e lParam . Se você superestimar, a memória extra será alocada, se você subestimar, a alocação normal será usada para itens que excedem o valor solicitado.

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
Winuser.h (inclua Windows.h)

Confira também

Referência

CB_ADDSTRING

CB_DIR

CB_INSERTSTRING