CComboBox::AddString (MFC)

Switch View :

ScriptFree

MFC Library Reference

CComboBox::AddString

Adds a string to the list box of a combo box.


int AddString(
   LPCTSTR lpszString 
);

Parameters

lpszString: Points to the null-terminated string that is to be added.

Return Value

If the return value is greater than or equal to 0, it is the zero-based index to the string in the list box. 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.

Remarks

If the list box was not created with the CBS_SORT style, the string is added to the end of the list. Otherwise, the string is inserted into the list, and the list is sorted.

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

To insert a string into a specific location within the list, use the InsertString member function.

Example

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

// Add 20 items to the combo box.
CString str;
for (int i=0;i < 20;i++)
{
   str.Format(_T("item string %d"), i);
   pmyComboBox->AddString( str );
}

Reference

CComboBox Class
Hierarchy Chart
CComboBox::InsertString
CComboBox::DeleteString
CB_ADDSTRING

Other Resources

CComboBox Members