CB_ADDSTRING
This message is sent by an application 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,
lParam = (LPARAM)(LPCSTR) lpsz
Parameters
- lpsz
Long pointer 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 zero-based index to the string in the list box of the combo box indicates success. CB_ERR indicates that an error has occurred. CB_ERRSPACE indicates that insufficient space is available to store the new string.
Remarks
To insert a string at a specific location within the list, use the CB_INSERTSTRING message.
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 1.0 and later | Winuser.h |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
CB_GETITEMDATA, CB_INSERTSTRING, CB_SETITEMDATA
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.