CListBox::AddString

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

更新 : 2007 年 11 月

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

int AddString(
   LPCTSTR lpszItem 
);

パラメータ

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

戻り値

リストボックス内の文字列の 0 から始まるインデックスを返します。エラーが発生した場合は LB_ERR を返します。新しい文字列を追加するための領域が不足している場合は LB_ERRSPACE を返します。

解説

LBS_SORT スタイルで作成されていないリストボックスでは、文字列はリストの最後に追加されます。それ以外の場合は、文字列がリストボックスに挿入された後にリストが並べ替えられます。LBS_HASSTRINGS スタイルではなく、LBS_SORT スタイルで作成されているリストボックスでは、フレームワークはリストを並べ替えるために、1 回以上 CompareItem メンバ関数を呼び出します。

リストボックス内の指定位置に挿入するには、InsertString 関数を使います。

使用例

// Add 10 items to the list box.
CString str;
for (int i = 0; i < 10; i++)
{
   str.Format(_T("item string %d"), i);
   m_myListBox.AddString( str );
}