CListBox::InsertString

更新 : 2007 年 11 月

リスト ボックスに文字列を挿入します。

int InsertString(
   int nIndex,
   LPCTSTR lpszItem 
);

パラメータ

  • nIndex
    文字列を挿入する位置を 0 から始まるインデックスで指定します。このパラメータが -1 の場合、文字列はリストの最後に追加されます。

  • lpszItem
    挿入する NULL で終わる文字列へのポインタ。

戻り値

文字列が挿入された位置を 0 から始まるインデックスで返します。エラーが発生した場合は LB_ERR を返します。新しい文字列を追加するための領域が不足している場合は LB_ERRSPACE を返します。

解説

AddString メンバ関数とは異なり、InsertString 関数は、LBS_SORT スタイルが指定されていても並べ替えません。

使用例

// Insert items in between existing items.
CString str;
int n = m_myListBox.GetCount();
for (int i = 0; i < n; i++)
{
   str.Format(_T("item string %c"), (char)('A' + i));
   m_myListBox.InsertString(2 * i, str);
}

必要条件

ヘッダー : afxwin.h

参照

参照

CListBox クラス

階層図

CListBox::AddString

LB_INSERTSTRING

その他の技術情報

CListBox のメンバ