LVFINDINFOA 结构（commctrl.h）

包含搜索列表视图项时使用的信息。此结构与LV_FINDINFO相同，但已重命名为适合标准命名约定。

语法

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

flags

类型：UINT

要执行的搜索类型。此成员可以设置为以下一个或多个值：

价值	意义
LVFI_PARAM	搜索此结构的 lParam 成员与项 LVITEM 结构的 lParam 成员之间的匹配项。
LVFI_PARTIAL	检查项文本是否以 psz 成员指向的字符串开头。此值表示使用LVFI_STRING。
LVFI_STRING	基于项文本进行搜索。除非指定了其他值，否则匹配项的项文本必须与 psz 成员指向的字符串完全匹配。但是，搜索不区分大小写。
LVFI_SUBSTRING	Windows Vista 及更高版本。等效于LVFI_PARTIAL。
LVFI_WRAP	如果找不到匹配项，则继续搜索开头。如果此标志本身使用，则假定需要字符串搜索。
LVFI_NEARESTXY	查找最接近 pt 成员中指定的位置的项，其方向由 vkDirection 成员指定。此标志仅受大型图标和小型图标模式支持。如果指定了LVFI_NEARESTXY，则忽略所有其他标志。

psz

类型：LPCTSTR

要与项文本进行比较的以 null 结尾的字符串的地址。仅在标志成员中设置LVFI_STRING或LVFI_PARTIAL时才有效。

lParam

类型：LPARAM

要与列表视图项 LVITEM 结构的 lParam 成员进行比较的值。仅在标志成员中设置LVFI_PARAM时才有效。

pt

类型：POINT

使用初始搜索位置 POINT 结构。仅在标志成员中设置LVFI_NEARESTXY时才有效。

vkDirection

类型：UINT

指定搜索方向的虚拟键代码。支持以下代码：

仅当在标志成员中设置LVFI_NEARESTXY时，此成员才有效。

注意

commctrl.h 标头将 LVFINDINFO 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。