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_ADDSTRING或LB_INSERTSTRING消息) lParam 参数 (具有长值的项。

要求

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

另请参阅

LB_FINDSTRINGEXACT