CB_ADDSTRING メッセージ
コンボ ボックスのリスト ボックスに文字列を追加します。 コンボ ボックスに CBS_SORT スタイルがない場合は、リストの末尾に文字列が追加されます。 それ以外の場合は、文字列がリストに挿入され、リストが並べ替えられます。
パラメーター
-
wParam
-
このパラメーターは使用されません。
-
lParam
-
追加する null で終わる文字列への LPCTSTR ポインター。 所有者が描画したスタイルで、 CBS_HASSTRINGS スタイルを使用せずにコンボ ボックスを作成した場合、 lParam パラメーターの値は、それ以外の場合は指す文字列ではなく、項目データとして格納されます。 アイテム データは、CB_GETITEMDATAまたはCB_SETITEMDATA メッセージを送信することで取得または変更できます。
戻り値
戻り値は、コンボ ボックスのリスト ボックス内の文字列に対する 0 から始まるインデックスです。 エラーが発生した場合、戻り値はCB_ERR。 新しい文字列を格納するために十分な領域が使用できない場合は、CB_ERRSPACE。
解説
CBS_SORT スタイルを持ち、CBS_HASSTRINGS スタイルを持たない所有者描画コンボ ボックスを作成した場合、WM_COMPAREITEM メッセージはコンボ ボックスの所有者に 1 回以上送信されるため、新しいアイテムをリストに適切に配置できます。
リスト内の特定の場所に文字列を挿入するには、 CB_INSERTSTRING メッセージを使用します。
コンボ ボックスに WS_HSCROLL スタイルがあり、コンボ ボックスよりも広い文字列を追加する場合は、水平スクロール バーが表示されるように LB_SETHORIZONTALEXTENT メッセージを送信します。
Comclt32.dllバージョン 5.0 以降:CBS_LOWERCASEまたはCBS_UPPERCASEが設定されている場合、Unicode バージョンの CB_ADDSTRING によって文字列が変更されます。 読み取り専用グローバル メモリを使用すると、アプリケーションが失敗します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| ヘッダー |
|