Win32 API 日本語リファレンス
ホームUI.Controls › LVHITTESTINFO

LVHITTESTINFO

構造体
サイズx64: 24 バイト / x86: 24 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
ptPOINT8+0+0ヒットテストを行う位置(クライアント座標)。
flagsLVHITTESTINFO_FLAGS4+8+8

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

LVHT_ABOVELVHT_BELOWLVHT_TOLEFTLVHT_TORIGHT を使用すると、リストビューコントロールの内容をスクロールするかどうかを判断できます。これらの値のうち 2 つを組み合わせることができます。たとえば、位置がクライアント領域の上かつ左にある場合は、LVHT_ABOVELVHT_TOLEFT の両方を使用できます。

LVHT_ONITEM を調べることで、指定した位置がリストビューアイテムの上にあるかどうかを判断できます。この値は LVHT_ONITEMICONLVHT_ONITEMLABELLVHT_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. ポイントはリストビューコントロールのフッター内にあります。
iItemINT4+12+12一致したアイテムのインデックスを受け取ります。サブアイテムのヒットテストを行う場合、この値はサブアイテムの親アイテムを表します。
iSubItemINT4+16+16バージョン 4.70。一致したサブアイテムのインデックスを受け取ります。アイテムのヒットテストを行う場合、このメンバーは 0 になります。
iGroupINT4+20+20Windows Vista。ヒットしたアイテムのグループインデックス(読み取り専用)。オーナーデータの場合にのみ有効です。ポイントが複数のグループに表示されるアイテム内にある場合、iGroup はそのアイテムのグループインデックスを指定します。

公式ドキュメント

ヒットテストに関する情報を格納します。この構造体は、サブアイテムのヒットテストに対応できるよう拡張されています。LVM_HITTEST および LVM_SUBITEMHITTEST メッセージと、それらに関連するマクロと組み合わせて使用します。この構造体は LVHITTESTINFO 構造体に代わるものです。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// POINT  (x64 8 / x86 8 バイト)
typedef struct POINT {
    INT x;
    INT y;
} POINT;

// LVHITTESTINFO  (x64 24 / x86 24 バイト)
typedef struct LVHITTESTINFO {
    POINT pt;
    LVHITTESTINFO_FLAGS flags;
    INT iItem;
    INT iSubItem;
    INT iGroup;
} LVHITTESTINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINT
{
    public int x;
    public int y;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LVHITTESTINFO
{
    public POINT pt;
    public uint flags;
    public int iItem;
    public int iSubItem;
    public int iGroup;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINT
    Public x As Integer
    Public y As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LVHITTESTINFO
    Public pt As POINT
    Public flags As UInteger
    Public iItem As Integer
    Public iSubItem As Integer
    Public iGroup As Integer
End Structure
import ctypes
from ctypes import wintypes

class POINT(ctypes.Structure):
    _fields_ = [
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
    ]

class LVHITTESTINFO(ctypes.Structure):
    _fields_ = [
        ("pt", POINT),
        ("flags", wintypes.DWORD),
        ("iItem", ctypes.c_int),
        ("iSubItem", ctypes.c_int),
        ("iGroup", ctypes.c_int),
    ]
#[repr(C)]
pub struct POINT {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct LVHITTESTINFO {
    pub pt: POINT,
    pub flags: u32,
    pub iItem: i32,
    pub iSubItem: i32,
    pub iGroup: i32,
}
import "golang.org/x/sys/windows"

type POINT struct {
	x int32
	y int32
}

type LVHITTESTINFO struct {
	pt POINT
	flags uint32
	iItem int32
	iSubItem int32
	iGroup int32
}
type
  POINT = record
    x: Integer;
    y: Integer;
  end;

  LVHITTESTINFO = record
    pt: POINT;
    flags: DWORD;
    iItem: Integer;
    iSubItem: Integer;
    iGroup: Integer;
  end;
const POINT = extern struct {
    x: i32,
    y: i32,
};

const LVHITTESTINFO = extern struct {
    pt: POINT,
    flags: u32,
    iItem: i32,
    iSubItem: i32,
    iGroup: i32,
};
type
  POINT {.bycopy.} = object
    x: int32
    y: int32

  LVHITTESTINFO {.bycopy.} = object
    pt: POINT
    flags: uint32
    iItem: int32
    iSubItem: int32
    iGroup: int32
struct POINT
{
    int x;
    int y;
}

struct LVHITTESTINFO
{
    POINT pt;
    uint flags;
    int iItem;
    int iSubItem;
    int iGroup;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LVHITTESTINFO サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; pt : POINT (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; flags : LVHITTESTINFO_FLAGS (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; iItem : INT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; iSubItem : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; iGroup : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global POINT
    #field int x
    #field int y
#endstruct

#defstruct global LVHITTESTINFO
    #field POINT pt
    #field int flags
    #field int iItem
    #field int iSubItem
    #field int iGroup
#endstruct

stdim st, LVHITTESTINFO        ; NSTRUCT 変数を確保
st->flags = 100
mes "flags=" + st->flags