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	按 vkDirection 成员指定的方向查找最接近 pt 成员中指定的位置的项。只有大图标和小图标模式才支持此标志。如果指定了LVFI_NEARESTXY，则忽略所有其他标志。

psz

类型： LPCTSTR

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

lParam

类型： LPARAM

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

pt

类型： POINT

具有初始搜索位置的 POINT 结构。仅当 在 flags 成员中设置了LVFI_NEARESTXY时，它才有效。

vkDirection

类型： UINT

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

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

注意

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