CComboBox::InsertString

更新 : 2007 年 11 月

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

int InsertString(
   int nIndex,
   LPCTSTR lpszString 
);

パラメータ

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

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

戻り値

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

解説

AddString メンバ関数とは異なり、InsertString メンバ関数では、CBS_SORT スタイルが設定されていても、挿入後にリストを並べ替えません。

fshs3k34.alert_note(ja-jp,VS.90).gifメモ :

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

使用例

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

必要条件

ヘッダー : afxwin.h

参照

参照

CComboBox クラス

階層図

CComboBox::AddString

CComboBox::DeleteString

CComboBox::ResetContent

CB_INSERTSTRING

その他の技術情報

CComboBox のメンバ