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 [デスクトップ アプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)

関連項目

参照

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM