CB_ADDSTRING消息
将字符串添加到组合框的列表框。 如果组合框没有 CBS_SORT 样式,则会将字符串添加到列表的末尾。 否则,会将字符串插入到列表中,并对列表进行排序。
参数
-
wParam
-
未使用此参数。
-
lParam
-
指向要添加的以 null 结尾的字符串的 LPCTSTR 指针。 如果使用所有者绘制的样式创建组合框,但没有 CBS_HASSTRINGS 样式, 则 lParam 参数的值将存储为项数据,而不是它以其他方式指向的字符串。 可以通过发送CB_GETITEMDATA或CB_SETITEMDATA消息来检索或修改项数据。
返回值
返回值是组合框列表框中字符串的从零开始的索引。 如果发生错误,则返回值CB_ERR。 如果没有足够的空间来存储新字符串,则CB_ERRSPACE。
备注
如果创建具有 CBS_SORT 样式但没有 CBS_HASSTRINGS 样式的所有者绘制组合框, 则WM_COMPAREITEM 消息将一次或多次发送给组合框的所有者,以便新项可以正确放置在列表中。
若要在列表中的特定位置插入字符串,请使用 CB_INSERTSTRING 消息。
如果组合框具有 WS_HSCROLL 样式,并且您添加的字符串比组合框更宽,请发送 LB_SETHORIZONTALEXTENT 消息以确保显示水平滚动条。
Comclt32.dll版本 5.0 或更高版本: 如果设置了 CBS_LOWERCASE 或 CBS_UPPERCASE ,则 CB_ADDSTRING 的 Unicode 版本会更改字符串。 如果使用只读全局内存,则会导致应用程序失败。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|