LB_INITSTORAGE訊息

分配記憶體來儲存清單框項目。 此訊息可在應用程式新增大量項目到清單框之前使用。

參數

wParam

預留空間的物品數量。

Windows 95/Windows 98/Windows 千禧版（Windows Me）： wParam 參數限制為 16 位元值。 這表示清單框不能包含超過 32,767 個專案。 雖然項目數量有限，但清單框中項目的總大小（以位元組計）僅受限於可用記憶體。

lParam

額外記憶體（以位元組）分配給項目字串。

返回值

若訊息成功，回傳值即為清單框在需要記憶體重新配置前可儲存的項目總數。

若訊息失敗，回傳值為 LB_ERRSPACE。

Microsoft Windows NT 4.0：此訊息未分配指定的記憶體容量;但它總是回傳 wParam 參數中指定的值。

備註

LB_INITSTORAGE訊息有助於加速包含大量項目（超過 100 個）清單框的初始化。 它保留指定的記憶體容量，使後續的 LB_ADDSTRING、 LB_INSERTSTRING、 LB_DIR 和 LB_ADDFILE 訊息更有效率。 你可以用 wParam 和 lParam 參數的估計值。 如果你高估了，額外的記憶體仍會被分配;如果你低估了，清單框會根據需要分配額外記憶體。

儲存字串所需的記憶體包含空終止符。 因此，如果你打算加入 100 個字串，每個字串長度為 10 字元，你就會傳遞一個 100 的 wParam 和一個 100 × （10 + 1） × sizeof（TCHAR）。

需求

另請參閱

參考

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING