CListBox::InitStorage

Artigo
08/25/2010

Aloca memória para armazenar lista-caixa itens.

int InitStorage(
   int nItems,
   UINT nBytes 
);

Parâmetros

nItems
Especifica o número de itens para adicionar.
nBytes
Especifica a quantidade de memória, em bytes, para alocar seqüências de caracteres do item.

Valor de retorno

Se for bem-sucedido, o número máximo de itens que a caixa de listagem pode armazenar antes uma realocação de memória é necessário, caso contrário, LB_ERRSPACE, significando que não há memória suficiente está disponível.

Comentários

telefonar Essa função antes de adicionar um grande número de itens a um CListBox.

Essa função ajuda a acelerar a inicialização de caixas de listagem que tem um grande número de itens (mais de 100).A quantidade especificada de memória subseqüente assim que ele preallocates AddString, InsertString, and Dir funções utilizam menor time possível.Você pode utilizar estimativas para os parâmetros.Se overestimate, alguma memória adicional é alocada; se você subestimar, alocação normal é usada para itens que excederem a quantidade pré-distribuída.

Windows 95/98 somente: The nItems parâmetro está limitado a valores de 16 bit. Isso significa lista caixas não podem conter mais de 32.767 itens.Embora o número de itens é restrito, o dimensionar total dos itens em um lista caixa é limitada apenas pela memória disponível.

Exemplo

// Initialize the storage of the list box to be 256 strings with
// about 10 characters per string, performance improvement.
int n = m_myListBox.InitStorage(256, 10);
ASSERT(n != LB_ERRSPACE);

// Add 256 items to the list box.
CString str;
for (int i = 0; i < 256; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString( str );
}