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 [仅限桌面应用]
标头	Winuser.h (包括 Windows.h)

另请参阅

引用

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING