LB_INITSTORAGE メッセージ

リスト ボックス項目を格納するためのメモリを割り当てます。 このメッセージは、アプリケーションがリスト ボックスに多数の項目を追加する前に使用されます。

パラメーター

wParam

追加する項目の数。

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam パラメーターは 16 ビット値に制限されています。 つまり、リスト ボックスには 32,767 個を超えるアイテムを含めることはできません。 項目の数は制限されていますが、リスト ボックス内のアイテムの合計サイズ (バイト単位) は、使用可能なメモリによってのみ制限されます。

lParam

項目文字列に割り当てるメモリの量 (バイト単位)。

戻り値

メッセージが成功した場合、戻り値は、メモリが事前に割り当てられたアイテムの合計数、つまり、成功したすべての LB_INITSTORAGE メッセージによって追加されたアイテムの合計数です。

メッセージが失敗した場合、戻り値はLB_ERRSPACE。

Microsoft Windows NT 4.0: このメッセージは、指定された量のメモリを割り当てませんが、wParam パラメーターで指定された値を常に返します。

解説

LB_INITSTORAGE メッセージは、多数の項目 (100 個を超える) を含むリスト ボックスの初期化を高速化するのに役立ちます。 指定された量のメモリを予約して、後続の LB_ADDSTRING、 LB_INSERTSTRING、 LB_DIR、 およびLB_ADDFILE メッセージが可能な限り短い時間を要するようにします。 wParam パラメーターと lParam パラメーターの推定値を使用できます。 過大評価すると、余分なメモリが割り当てられます。過小評価する場合は、要求された金額を超えるアイテムに対して通常の割り当てが使用されます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)

関連項目

参照

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING