This documentation is archived and is not being maintained.

CComboBox::InsertString 

Inserts a string into the list box of a combo box.


int InsertString(
   int nIndex,
   LPCTSTR lpszString 
);

Parameters

nIndex

Contains the zero-based index to the position in the list box that will receive the string. If this parameter is –1, the string is added to the end of the list.

lpszString

Points to the null-terminated string that is to be inserted.

The zero-based index of the position at which the string was inserted. The return value is CB_ERR if an error occurs. The return value is CB_ERRSPACE if insufficient space is available to store the new string.

Unlike the AddString member function, the InsertString member function does not cause a list with the CBS_SORT style to be sorted.

NoteNote

This function is not supported by the Windows ComboBoxEx control. For more information on this control, see ComboBoxEx Controls in the Platform SDK.

// The pointer to my combo box.
extern CComboBox* pmyComboBox;

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