CComboBox::AddString

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

コンボボックスのリストボックスに文字列を追加します。

int AddString(
   LPCTSTR lpszString 
);

パラメータ

lpszString
追加する NULL で終わる文字列へのポインタ。

戻り値

戻り値が 0 以上の場合、リストボックス内の文字列の位置を 0 から始まるインデックスで示します。エラーが発生した場合は、CB_ERR を返します。メモリ不足のために新しい文字列をリストボックスに挿入できない場合は、CB_ERRSPACE を返します。

解説

リストボックスが CBS_SORT スタイルで作成されていない場合、文字列はリストボックスの末尾に追加されます。それ以外の場合は、文字列がリストボックスに挿入された後にリストが並べ替えられます。

メモ :
この関数は、Windows の ComboBoxEx コントロールではサポートされていません。このコントロールの詳細については、Windows SDK の「ComboBoxEx Controls」を参照してください。

リスト内の特定の位置に文字列を挿入する場合は、InsertString メンバ関数を使います。

使用例

// Add 20 items to the combo box.
CString str;
for (int i = 0; i < 20; i++)
{
   str.Format(_T("item string %d"), i);
   m_pComboBox->AddString(str);
}