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)