共用方式為


CListBox::InitStorage

配置中的清單方塊項目記憶體。

int InitStorage(
   int nItems,
   UINT nBytes 
);

參數

  • nItems
    指定項目數目增加。

  • nBytes
    以位元組指定記憶體數量,,為項目字串配置。

傳回值

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

備註

在加入大量項目之前呼叫這個函式加入至 CListBox

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

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

範例

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

需求

Header: afxwin.h

請參閱

參考

CListBox 類別

階層架構圖

CListBox::CListBox

CListBox::Create

CListBox::ResetContent

LB_INITSTORAGE