CListBox::InitStorage

發行項
06/10/2015

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

int InitStorage( 
   int nItems, 
   UINT nBytes  
);

參數

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

傳回值

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

備註

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

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

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