CComboBox::InitStorage

發行項
02/28/2013

配置中的清單方塊項目記憶體在下拉式方塊的清單方塊部分。

int InitStorage(
   int nItems,
   UINT nBytes 
);

參數

nItems
指定項目數目增加。
nBytes
以位元組指定記憶體數量，，為項目字串配置。

傳回值

如果成功，下拉式方塊的清單方塊部分可以儲存項目的最大數目，在記憶體重新配置所需的之前，則為 CB_ERRSPACE，這表示沒有足夠的記憶體可供使用。

備註

在加入大量項目之前呼叫這個函式加入至 CComboBox的清單方塊部分。

Windows 95: /98 只 wParam 參數限制為 16 位元值。這表示清單方塊不能包含超過 32,767 個項目。雖然項目數目受到限制，項目的總大小在清單方塊中的可用記憶體僅條件。

這個函式有助於加速具有大量項目清單方塊的初始化 (超過 100)。它預先配置指定的記憶體數量，使後續 AddString、 InsertString和 Dir 函式所花費的時間可能的最短時間。您可以對參數使用評估。如果評估過高，某些額外的記憶體配置您;如果您低估資料，一般配置在多種預先配置的數量的項目使用。

範例

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