CComboBox::InitStorage

Artigo
08/25/2010

Aloca memória para armazenar lista caixa itens no lista-parte caixa de caixa de combinação.

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 o lista-parte caixa de caixa de combinação pode armazenar antes uma realocação de memória for necessária, caso contrário, CB_ERRSPACE, significando que não há memória suficiente está disponível.

Comentários

Chamar essa função antes de adicionar um grande número de itens para o lista-parte da caixa do CComboBox.

Windows 95/98 somente: The wParam 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.

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.

Exemplo

// Initialize the storage of the combo box to be 256 strings with
// about 10 characters per string, performance improvement.
int nAlloc = pmyComboBox->InitStorage(256, 10);
ASSERT(nAlloc != CB_ERRSPACE);

// Add 256 items to the combo box.
CString strAdd;
for (int i = 0; i < 256; i++)
{
   strAdd.Format(_T("item string %d"), i);
   m_pComboBox->AddString(strAdd);
}