int InitStorage (int nItems, UINT nBytes );
Valor de retorno
Se for bem-sucedida, o número máximo de itens que a caixa de listagem pode armazenar antes uma realocação de memória é necessária, caso contrário LB_ERRSPACE, significando que não há memória suficiente está disponível.
Parâmetros
nItems
Especifica o número de itens para adicionar.
nBytes
Especifica a quantidade de memória, em bytes, alocar para seqüências de caracteres de item.
Observações
Aloca memória para armazenar itens de lista-caixa. Chamar esta função antes de adicionar um grande número de itens a um CListBox.
Essa função ajuda a acelerar a inicialização das caixas de listagem que tem um grande número de itens (mais de 100). Ele preallocates a quantidade especificada de memória para que funções AddString, InsertStringe Dir subseqüentes levar o menor tempo possível. Você pode usar estimativas para os parâmetros. Se você overestimate, alguma memória extra é alocada; Se você subestime, a alocação normal é usada para itens que excedem o montante pré-distribuído.
Windows 95 apenas: O parâmetro nItems é 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 dos itens em uma caixa de listagem é limitado apenas pela memória disponível.
Visão geral de CListBox | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CListBox::CListBox, CListBox::Create, CListBox::ResetContent, LB_INITSTORAGE