LVM_GETISEARCHSTRING消息

检索列表视图控件的增量搜索字符串。 可以显式发送此消息,也可以使用 ListView_GetISearchString 宏发送。

参数

wParam

必须为零。

lParam

指向接收增量搜索字符串的缓冲区的指针。 若要仅检索字符串的长度,请将 lParam 设置为 NULL

返回值

返回增量搜索字符串中的字符数(不包括终止 NULL 字符),如果列表视图控件不处于增量搜索模式,则返回零。

备注

安全警告: 错误使用此消息可能会危及程序的安全性。 此消息不提供了解缓冲区大小的方法。 如果使用此消息,请首先调用 lParam 中传递 NULL 的消息,这将返回字符数(不包括所需的 NULL)。 然后再次调用消息以检索字符串。 在继续之前,应查看 安全注意事项:Microsoft Windows 控件

增量搜索字符串是用户键入的字符序列,而列表视图具有输入焦点。 每次用户键入字符时,系统会将该字符追加到搜索字符串,然后搜索匹配项。 如果系统找到匹配项,它会选择该项,并在必要时将其滚动到视图中。

超时期限与用户键入的每个字符相关联。 如果用户键入另一个字符之前超时期限过,则会重置增量搜索字符串。

确保缓冲区足够大,以容纳字符串和终止 NULL 字符。 如果它太小,将立即导致页面错误无效。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h
Unicode 和 ANSI 名称
LVM_GETISEARCHSTRINGW (Unicode) 和 LVM_GETISEARCHSTRINGA (ANSI)