CB_ADDSTRING消息

将字符串添加到组合框的列表框。 如果组合框没有 CBS_SORT 样式,则会将字符串添加到列表的末尾。 否则,会将字符串插入到列表中,并对列表进行排序。

参数

wParam

未使用此参数。

lParam

指向要添加的以 null 结尾的字符串的 LPCTSTR 指针。 如果使用所有者绘制的样式创建组合框,但没有 CBS_HASSTRINGS 样式, 则 lParam 参数的值将存储为项数据,而不是它以其他方式指向的字符串。 可以通过发送CB_GETITEMDATACB_SETITEMDATA消息来检索或修改项数据。

返回值

返回值是组合框列表框中字符串的从零开始的索引。 如果发生错误,则返回值CB_ERR。 如果没有足够的空间来存储新字符串,则CB_ERRSPACE。

备注

如果创建具有 CBS_SORT 样式但没有 CBS_HASSTRINGS 样式的所有者绘制组合框, 则WM_COMPAREITEM 消息将一次或多次发送给组合框的所有者,以便新项可以正确放置在列表中。

若要在列表中的特定位置插入字符串,请使用 CB_INSERTSTRING 消息。

如果组合框具有 WS_HSCROLL 样式,并且您添加的字符串比组合框更宽,请发送 LB_SETHORIZONTALEXTENT 消息以确保显示水平滚动条。

Comclt32.dll版本 5.0 或更高版本: 如果设置了 CBS_LOWERCASECBS_UPPERCASE ,则 CB_ADDSTRING 的 Unicode 版本会更改字符串。 如果使用只读全局内存,则会导致应用程序失败。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Winuser.h (包括 Windows.h)

另请参阅

引用

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM