We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.


Inserts a string into the list box.

int InsertString(
   int nIndex,
   LPCTSTR lpszItem 


Specifies the zero-based index of the position to insert the string. If this parameter is –1, the string is added to the end of the list.


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 LB_ERR if an error occurs; the return value is LB_ERRSPACE if insufficient space is available to store the new string.

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

// 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);

Header: afxwin.h