CB_INITSTORAGE

[Esta é a documentação preliminar e estão sujeitos a alterações.]

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

CB_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.
cb
Especifica a quantidade de memória para alocar para seqüências de caracteres de item, em bytes.

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 CB_INITSTORAGE bem sucedidas.

Se a mensagem falhar, o valor de retorno é CB_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 CB_INITSTORAGE ajuda a acelerar a inicialização de caixas de combinação que tem um grande número de itens (mais de 100). Reserva-se a quantidade especificada de memória para que mensagens subseqüentes de CB_ADDSTRING, CB_INSERTSTRING e CB_DIR tomar o menor tempo possível. Você pode usar estimativas para a cItems e cb parâmetros. Se você overestimate, é alocada a memória extra, se você subestime, a alocação normal é usada para itens que excedam a quantidade solicitada.

QuickInfo

nbsp; Windows &NT: requer versão 5.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 combinação, as mensagens de caixa de combinação, CB_ADDSTRING, CB_DIR, CB_INSERTSTRING

Index