CComboBox::InitStorage

Artículo
06/10/2015

Asigna memoria para almacenar elementos de cuadro de lista de la parte del cuadro de lista del cuadro combinado.

int InitStorage( 
   int nItems, 
   UINT nBytes  
);

Parámetros

nItems
especifica el número de elementos para agregar.
nBytes
Especifica la cantidad de memoria, en bytes, para asignar para las cadenas del elemento.

Valor devuelto

Si es correcto, el número máximo de elementos que la parte del cuadro de lista del cuadro combinado puede almacenar antes de que una reasignación de memoria es necesaria, si no CB_ERRSPACE, que no suficiente memoria disponible.

Comentarios

Llame a esta función antes de agregar un gran número de elementos a la parte del cuadro de lista de CComboBox.

Windows 95 /98 sólo: el parámetro de wParam se limita a los valores de 16 bits. esto significa que los cuadros de lista no pueden contener más de 32.767 elementos. Aunque el número de elementos se limita, el tamaño total de los elementos en un cuadro de lista está limitado por la memoria disponible.

Esta función ayuda a acelerar la inicialización de los cuadros de lista con un gran número de elementos (más de 100). Reserva la cantidad de memoria especificada de modo que las funciones subsiguientes de AddString, de InsertString, y de Dir tarden tiempo posible más corto. Puede utilizar las estimaciones de los parámetros. Si le sobrestimación, alguna memoria adicional asignan; si le underestimate, la asignación normal utilizan para los elementos que superan la cantidad reservado.

Ejemplo

// 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);
}