TVM_GETISEARCHSTRING消息

检索树视图控件的增量搜索字符串。 树视图控件使用增量搜索字符串根据用户键入的字符选择项。 可以显式发送此消息，也可以使用 TreeView_GetISearchString 宏发送。

参数

wParam

必须为零。

lParam

指向接收增量搜索字符串的缓冲区的指针。

返回值

返回增量搜索字符串中的字符数。

备注

安全警告： 错误使用此消息可能会损害程序的安全性。 必须分配足够大的缓冲区来保存字符串。 首先调用 lParam 中传递 NULL 的消息。 这将返回所需的字符数（不包括 NULL）。 然后再次调用消息以检索字符串。 在继续操作之前，应查看 安全注意事项：Microsoft Windows 控件 。

如果树视图控件不处于增量搜索模式，则返回值为零。

要求

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