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

ヒット テストの結果に関する情報を受け取る変数。 このメンバーには、次の値の 1 つ以上を指定できます。

LVHT_ABOVE、LVHT_BELOW、LVHT_TOLEFT、LVHT_TORIGHTを使用して、リスト ビュー コントロールの内容をスクロールするかどうかを判断できます。 これらの値のうち 2 つを組み合わせて使用できます。 たとえば、位置がクライアント領域の上と左側にある場合は、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。 一致するサブ項目のインデックスを受け取ります。 項目をヒット テストすると、このメンバーは 0 になります。

iGroup

型: int

Windows Vista。 項目ヒットのグループ インデックス (読み取り専用)。 所有者データに対してのみ有効です。 ポイントが複数のグループで表示されるアイテム内にある場合、 iGroup はアイテムのグループ インデックスを指定します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header commctrl.h