ListView_GetISearchString 宏（commctrl.h）

获取列表视图控件的增量搜索字符串。可以使用此宏或显式发送 LVM_GETISEARCHSTRING 消息。

语法

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

hwndLV

类型：HWND

列表视图控件的句柄。

lpsz

类型：LPSTR

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

类型：BOOL

返回增量搜索字符串中的字符数;如果列表视图控件不在增量搜索模式下，则返回零。

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

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

确保缓冲区足够大，足以保存字符串。如果它太小，则立即导致页面错误无效。