TreeView_GetISearchString 宏 (commctrl.h)

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

语法

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR lpsz
);

参数

hwndTV

类型:HWND

树视图控件的句柄。

lpsz

类型:LPTSTR

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

返回值

类型:BOOL

如果检索字符串,则返回 TRUE;否则 FALSE

言论

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

如果树视图控件不在增量搜索模式下,则返回值为零。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h