CComboBox::InsertString

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

更新 : 2007 年 11 月

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

int InsertString(
   int nIndex,
   LPCTSTR lpszString 
);

パラメータ

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

戻り値

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

解説

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

メモ :
この関数は、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);
}