LB_SELECTSTRING消息
在列表框中搜索以指定字符串中的字符开头的项。 如果找到匹配项,则选择该项。
参数
-
wParam
-
项的从零开始的索引,该项在要搜索的第一个项之前。 当搜索到达列表框的底部时,它会从列表框的顶部继续返回到 wParam 参数指定的项。 如果 wParam 为 -1,则从头开始搜索整个列表框。
Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam 参数限制为 16 位值。 这意味着列表框不能包含超过 32,767 个项。 尽管项数受到限制,但列表框中项的总大小(以字节为单位)仅受可用内存的限制。
-
lParam
-
指向以 null 结尾的字符串的指针,该字符串包含要搜索的前缀。 搜索不区分大小写,因此该字符串可以包含大写和小写字母的任意组合。
返回值
如果搜索成功,则返回值为所选项的索引。 如果搜索不成功,则返回值LB_ERR且当前所选内容不会更改。
注解
如有必要,将滚动列表框以显示所选项。
不要将此邮件与具有 LBS_MULTIPLESEL 或 LBS_EXTENDEDSEL 样式的列表框一起使用。
仅当项目从起始点开始的初始字符与 lParam 参数指定的字符串中的字符匹配时,才会选择该项。
如果列表框具有所有者绘制的样式,但没有 LBS_HASSTRINGS 样式, 则LB_SELECTSTRING 执行的操作取决于是否使用 LBS_SORT 样式。 如果使用 LBS_SORT ,系统会向列表框所有者发送 WM_COMPAREITEM 消息,以确定哪个项与指定的字符串匹配。 否则,LB_SELECTSTRING尝试查找具有长值的项, (作为与 lParam 参数匹配的LB_ADDSTRING或LB_INSERTSTRING消息) 的 lParam 参数提供。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|