ListView_GetISearchString 宏 (commctrl.h)

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

语法

void ListView_GetISearchString(
   hwndLV,
   lpsz
);

参数

hwndLV

类型： HWND

列表视图控件的句柄。

lpsz

类型： LPSTR

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

返回值

无

备注

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

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

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

要求