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 會指定專案的群組索引。