CComboBox::InitStorage

Article
03/04/2013

Alloue de la mémoire pour stocker des éléments de zone de liste située dans la partie zone de liste de la zone de liste déroulante.

int InitStorage(
   int nItems,
   UINT nBytes 
);

Paramètres

nItems
Spécifie le nombre d'éléments à ajouter.
nBytes
Spécifie la quantité de mémoire, en octets, pour allouer des chaînes d'élément.

Valeur de retour

En cas de réussite, le nombre maximal d'éléments que la partie zone de liste de la zone de liste déroulante peut stocker avant qu'une réallocation de mémoire soit nécessaire, sinon CB_ERRSPACE, ce qui signifie pas assez de mémoire est disponible.

Notes

Appelez cette fonction avant d'ajouter un grand nombre d'éléments de la partie zone de liste d' CComboBox.

Windows 95/98 uniquement : le paramètre d' wParam est limité aux valeurs 16 bits.Cela signifie que les zones de liste ne peuvent pas contenir plus de 32.767 éléments.Bien que le nombre d'éléments est restreint, la taille totale des éléments dans une zone de liste est limitée uniquement par la mémoire disponible.

Cette fonction permet d'accélérer l'initialisation des zones de liste comportant un grand nombre d'éléments (plus de 100).Il préaffecte la valeur spécifiée de mémoire afin que les fonctions suivantes d' AddString, d' InsertString, et de Dir prennent du temps le plus court possible.Vous pouvez utiliser des estimations des paramètres.Si vous sur-estimation, une mémoire supplémentaire est alloué ; si vous underestimate, l'allocation normale est utilisé pour les éléments qui dépassent la quantité préaffectée.

Exemple

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