CB_INITSTORAGE メッセージ
アプリケーションは、コンボ ボックスのリスト ボックス部分に多数の項目を追加する前に、 CB_INITSTORAGE メッセージを送信します。 このメッセージは、リスト ボックス項目を格納するためのメモリを割り当てます。
パラメーター
-
wParam
-
追加する項目の数。
-
lParam
-
項目文字列に割り当てるメモリの量 (バイト単位)。
戻り値
メッセージが成功した場合、戻り値は、メモリが事前に割り当てられたアイテムの合計数、つまり、成功したすべての CB_INITSTORAGE メッセージによって追加されたアイテムの合計数です。
メッセージが失敗した場合、戻り値はCB_ERRSPACE。
メッセージはメモリを割り当て、上記の成功値とエラー値を返します。
注釈
CB_INITSTORAGE メッセージは、多数の項目 (100 を超える) を持つコンボ ボックスの初期化を高速化するのに役立ちます。 指定した量のメモリを予約して、後続の CB_ADDSTRING、 CB_INSERTSTRING、 およびCB_DIR メッセージが可能な限り短い時間を取るようにします。 wParam パラメーターと lParam パラメーターの推定値を使用できます。 過大評価すると、余分なメモリが割り当てられます。過小評価すると、要求された量を超えるアイテムに対して通常の割り当てが使用されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|