LVHITTESTINFO 结构 (commctrl.h)

包含有关命中测试的信息。此结构已扩展，以适应子项命中测试。它与 LVM_HITTEST 和 LVM_SUBITEMHITTEST 消息及其相关宏相关联。此结构取代 了 LVHITTESTINFO 结构。

语法

typedef struct tagLVHITTESTINFO {
  POINT pt;
  UINT  flags;
  int   iItem;
  int   iSubItem;
  int   iGroup;
} LVHITTESTINFO, *LPLVHITTESTINFO;

pt

类型： POINT

要命中测试的位置，以客户端坐标表示。

flags

类型： UINT

接收有关命中测试结果信息的变量。此成员可以是以下一个或多个值：

可以使用LVHT_ABOVE、LVHT_BELOW、LVHT_TOLEFT和LVHT_TORIGHT确定是否滚动列表视图控件的内容。其中两个值可以组合在一起。例如，如果位置位于工作区的上方和左侧，则可以同时使用 LVHT_ABOVE 和 LVHT_TOLEFT。

可以测试LVHT_ONITEM，以确定指定位置是否位于列表视图项上方。此值是LVHT_ONITEMICON、LVHT_ONITEMLABEL和LVHT_ONITEMSTATEICON上的按位 OR 运算。

值	含义
LVHT_ABOVE	该位置位于控件的工作区上方。
LVHT_BELOW	该位置位于控件的工作区下方。
LVHT_NOWHERE	该位置位于列表视图控件的客户端窗口中，但不位于列表项上方。
LVHT_ONITEMICON	该位置位于列表视图项的图标上方。
LVHT_ONITEMLABEL	该位置位于列表视图项的文本上方。
LVHT_ONITEMSTATEICON	位置位于列表视图项的状态图像上方。
LVHT_TOLEFT	该位置位于列表视图控件工作区的左侧。
LVHT_TORIGHT	位置位于列表视图控件工作区的右侧。
LVHT_EX_GROUP_HEADER	Windows Vista。点位于组标头内。
LVHT_EX_GROUP_FOOTER	Windows Vista。该点位于组页脚内。
LVHT_EX_GROUP_COLLAPSE	Windows Vista。该点位于组的折叠/展开按钮内。
LVHT_EX_GROUP_BACKGROUND	Windows Vista。该点位于显示项的组区域内。
LVHT_EX_GROUP_STATEICON	Windows Vista。该点位于组的状态图标内。
LVHT_EX_GROUP_SUBSETLINK	Windows Vista。该点位于组的子集链接内。
LVHT_EX_GROUP	Windows Vista。 LVHT_EX_GROUP_BACKGROUND \|LVHT_EX_GROUP_COLLAPSE \|LVHT_EX_GROUP_FOOTER \|LVHT_EX_GROUP_HEADER \|LVHT_EX_GROUP_STATEICON \|LVHT_EX_GROUP_SUBSETLINK。
LVHT_EX_ONCONTENTS	Windows Vista。该点位于项目的图标或文本内容内，而不是在背景上。
LVHT_EX_FOOTER	Windows Vista。该点位于列表视图控件的页脚内。

iItem

类型： int

接收匹配项的索引。或者，如果命中测试子项，则此值表示子项的父项。

iSubItem

类型： int

版本 4.70。接收匹配子项的索引。命中测试项时，此成员将为零。

iGroup

类型： int

Windows Vista。命中项的组索引 (只读) 。仅对所有者数据有效。如果点位于显示在多个组中的项内，则 iGroup 将指定该项的组索引。