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

NMITEMACTIVATE

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

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

フィールド

フィールドサイズx64x86説明
hdrNMHDR24/12+0+0NMHDR 構造体。この通知コードに関する情報を格納します。
iItemINT4+24+12リストビュー項目のインデックスです。通知で項目のインデックスが使用されない場合、このメンバーには -1 が格納されます。
iSubItemINT4+28+16サブ項目の 1 から始まるインデックスです。通知でサブ項目のインデックスが使用されない場合、または通知がサブ項目に適用されない場合、このメンバーには 0 が格納されます。
uNewStateDWORD4+32+20新しい項目の状態です。このメンバーは、これを使用しない通知コードでは 0 になります。
uOldStateDWORD4+36+24以前の項目の状態です。このメンバーは、これを使用しない通知コードでは 0 になります。
uChangedDWORD4+40+28変更された項目の属性を示すフラグのセットです。このメンバーは、これを使用しない通知では 0 になります。それ以外の場合は、LVITEM 構造体の mask メンバーと同じ値を取ることができます。
ptActionPOINT8+44+32POINT 構造体。イベントが発生した位置をクライアント座標で示します。このメンバーは、これを使用しない通知コードでは未定義です。
lParamLPARAM8/4+56+40項目のアプリケーション定義値です。このメンバーは、これを使用しない通知コードでは未定義です。
uKeyFlagsDWORD4+64+44

アクティブ化の時点で押されていた修飾キーです。このメンバーには 0 または次のフラグの組み合わせが格納されます。

Value Meaning
LVKF_ALT
キーが押されています。
LVKF_CONTROL
キーが押されています。
LVKF_SHIFT
キーが押されています。

公式ドキュメント

LVN_ITEMACTIVATE 通知コードに関する情報を格納します。

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

各言語での定義

#include <windows.h>

// NMHDR  (x64 24 / x86 12 バイト)
typedef struct NMHDR {
    HWND hwndFrom;
    UINT_PTR idFrom;
    DWORD code;
} NMHDR;

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

// NMITEMACTIVATE  (x64 72 / x86 48 バイト)
typedef struct NMITEMACTIVATE {
    NMHDR hdr;
    INT iItem;
    INT iSubItem;
    DWORD uNewState;
    DWORD uOldState;
    DWORD uChanged;
    POINT ptAction;
    LPARAM lParam;
    DWORD uKeyFlags;
} NMITEMACTIVATE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMHDR
{
    public IntPtr hwndFrom;
    public UIntPtr idFrom;
    public uint code;
}

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

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMITEMACTIVATE
{
    public NMHDR hdr;
    public int iItem;
    public int iSubItem;
    public uint uNewState;
    public uint uOldState;
    public uint uChanged;
    public POINT ptAction;
    public IntPtr lParam;
    public uint uKeyFlags;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMHDR
    Public hwndFrom As IntPtr
    Public idFrom As UIntPtr
    Public code As UInteger
End Structure

<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 NMITEMACTIVATE
    Public hdr As NMHDR
    Public iItem As Integer
    Public iSubItem As Integer
    Public uNewState As UInteger
    Public uOldState As UInteger
    Public uChanged As UInteger
    Public ptAction As POINT
    Public lParam As IntPtr
    Public uKeyFlags As UInteger
End Structure
import ctypes
from ctypes import wintypes

class NMHDR(ctypes.Structure):
    _fields_ = [
        ("hwndFrom", ctypes.c_void_p),
        ("idFrom", ctypes.c_size_t),
        ("code", wintypes.DWORD),
    ]

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

class NMITEMACTIVATE(ctypes.Structure):
    _fields_ = [
        ("hdr", NMHDR),
        ("iItem", ctypes.c_int),
        ("iSubItem", ctypes.c_int),
        ("uNewState", wintypes.DWORD),
        ("uOldState", wintypes.DWORD),
        ("uChanged", wintypes.DWORD),
        ("ptAction", POINT),
        ("lParam", ctypes.c_ssize_t),
        ("uKeyFlags", wintypes.DWORD),
    ]
#[repr(C)]
pub struct NMHDR {
    pub hwndFrom: *mut core::ffi::c_void,
    pub idFrom: usize,
    pub code: u32,
}

#[repr(C)]
pub struct POINT {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct NMITEMACTIVATE {
    pub hdr: NMHDR,
    pub iItem: i32,
    pub iSubItem: i32,
    pub uNewState: u32,
    pub uOldState: u32,
    pub uChanged: u32,
    pub ptAction: POINT,
    pub lParam: isize,
    pub uKeyFlags: u32,
}
import "golang.org/x/sys/windows"

type NMHDR struct {
	hwndFrom uintptr
	idFrom uintptr
	code uint32
}

type POINT struct {
	x int32
	y int32
}

type NMITEMACTIVATE struct {
	hdr NMHDR
	iItem int32
	iSubItem int32
	uNewState uint32
	uOldState uint32
	uChanged uint32
	ptAction POINT
	lParam uintptr
	uKeyFlags uint32
}
type
  NMHDR = record
    hwndFrom: Pointer;
    idFrom: NativeUInt;
    code: DWORD;
  end;

  POINT = record
    x: Integer;
    y: Integer;
  end;

  NMITEMACTIVATE = record
    hdr: NMHDR;
    iItem: Integer;
    iSubItem: Integer;
    uNewState: DWORD;
    uOldState: DWORD;
    uChanged: DWORD;
    ptAction: POINT;
    lParam: NativeInt;
    uKeyFlags: DWORD;
  end;
const NMHDR = extern struct {
    hwndFrom: ?*anyopaque,
    idFrom: usize,
    code: u32,
};

const POINT = extern struct {
    x: i32,
    y: i32,
};

const NMITEMACTIVATE = extern struct {
    hdr: NMHDR,
    iItem: i32,
    iSubItem: i32,
    uNewState: u32,
    uOldState: u32,
    uChanged: u32,
    ptAction: POINT,
    lParam: isize,
    uKeyFlags: u32,
};
type
  NMHDR {.bycopy.} = object
    hwndFrom: pointer
    idFrom: uint
    code: uint32

  POINT {.bycopy.} = object
    x: int32
    y: int32

  NMITEMACTIVATE {.bycopy.} = object
    hdr: NMHDR
    iItem: int32
    iSubItem: int32
    uNewState: uint32
    uOldState: uint32
    uChanged: uint32
    ptAction: POINT
    lParam: int
    uKeyFlags: uint32
struct NMHDR
{
    void* hwndFrom;
    size_t idFrom;
    uint code;
}

struct POINT
{
    int x;
    int y;
}

struct NMITEMACTIVATE
{
    NMHDR hdr;
    int iItem;
    int iSubItem;
    uint uNewState;
    uint uOldState;
    uint uChanged;
    POINT ptAction;
    ptrdiff_t lParam;
    uint uKeyFlags;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NMITEMACTIVATE サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; hdr : NMHDR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; iItem : INT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; iSubItem : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; uNewState : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; uOldState : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; uChanged : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ptAction : POINT (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; lParam : LPARAM (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; uKeyFlags : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NMITEMACTIVATE サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; hdr : NMHDR (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; iItem : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; iSubItem : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; uNewState : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; uOldState : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; uChanged : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ptAction : POINT (+44, 8byte)  varptr(st)+44 を基点に操作(8byte:入れ子/配列)
; lParam : LPARAM (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; uKeyFlags : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global NMHDR
    #field intptr hwndFrom
    #field intptr idFrom
    #field int code
#endstruct

#defstruct global POINT
    #field int x
    #field int y
#endstruct

#defstruct global NMITEMACTIVATE
    #field NMHDR hdr
    #field int iItem
    #field int iSubItem
    #field int uNewState
    #field int uOldState
    #field int uChanged
    #field POINT ptAction
    #field intptr lParam
    #field int uKeyFlags
#endstruct

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