CB_ADDSTRING
An
application sends a CB_ADDSTRING message to add a string to the list box of a
combo box. If the combo box does not have 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.
CB_ADDSTRING
wParam = 0; // not used; must be
zero
lParam = (LPARAM) (LPCTSTR) lpsz; // address of string to add
Parameters
lpsz
Value of lParam.
Points to the null-terminated string to be added. If you create the combo box
with an owner-drawn style but without the CBS_HASSTRINGS style, the value of
the lpsz parameter is stored as item data rather than the string it
would otherwise point to. The item data can be retrieved or modified by sending
the CB_GETITEMDATA or CB_SETITEMDATA message.
Return Values
The return
value is the zero-based index to the string in the list box of the combo box.
If an error occurs, the return value is CB_ERR. If insufficient space is
available to store the new string, it is CB_ERRSPACE.
Remarks
If you create
an owner-drawn combo box with the CBS_SORT style but without the CBS_HASSTRINGS
style, the WM_COMPAREITEM message is sent one or more times to the owner of the
combo box so the new item can be properly placed in the list.
To insert a
string at a specific location within the list, use the CB_INSERTSTRING message.
See Also