LB_SELECTSTRING消息

在列表框中搜索以指定字符串中的字符开头的项。 如果找到匹配项,则选择该项。

参数

wParam

项的从零开始的索引,该项在要搜索的第一个项之前。 当搜索到达列表框的底部时,它会从列表框的顶部继续返回到 wParam 参数指定的项。 如果 wParam 为 -1,则从头开始搜索整个列表框。

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam 参数限制为 16 位值。 这意味着列表框不能包含超过 32,767 个项。 尽管项数受到限制,但列表框中项的总大小(以字节为单位)仅受可用内存的限制。

lParam

指向以 null 结尾的字符串的指针,该字符串包含要搜索的前缀。 搜索不区分大小写,因此该字符串可以包含大写和小写字母的任意组合。

返回值

如果搜索成功,则返回值为所选项的索引。 如果搜索不成功,则返回值LB_ERR且当前所选内容不会更改。

注解

如有必要,将滚动列表框以显示所选项。

不要将此邮件与具有 LBS_MULTIPLESELLBS_EXTENDEDSEL 样式的列表框一起使用。

仅当项目从起始点开始的初始字符与 lParam 参数指定的字符串中的字符匹配时,才会选择该项。

如果列表框具有所有者绘制的样式,但没有 LBS_HASSTRINGS 样式, 则LB_SELECTSTRING 执行的操作取决于是否使用 LBS_SORT 样式。 如果使用 LBS_SORT ,系统会向列表框所有者发送 WM_COMPAREITEM 消息,以确定哪个项与指定的字符串匹配。 否则,LB_SELECTSTRING尝试查找具有长值的项, (作为与 lParam 参数匹配的LB_ADDSTRINGLB_INSERTSTRING消息) 的 lParam 参数提供。

要求

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

另请参阅

引用

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING