LB_FINDSTRING消息

查找以指定字符串开头的列表框中的第一个字符串。

参数

wParam

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

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

lParam

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

返回值

返回值是匹配项的索引,如果搜索失败,则返回值LB_ERR。

备注

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

要求

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

另请参阅

LB_FINDSTRINGEXACT