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

NMTREEVIEWA

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

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

フィールド

フィールドサイズx64x86説明
hdrNMHDR24/12+0+0この通知メッセージに関する情報を格納する NMHDR 構造体です。
actionNM_TREEVIEW_ACTION4+24+12

通知固有のアクションフラグです。このメンバーは次の通知コードで使用されます。

指定できるアクションフラグの値については、TVM_EXPAND および TVN_SELCHANGED を参照してください。
itemOldTVITEMA56/40+32+16変更前の項目の状態に関する情報を格納する TVITEM 構造体です。このメンバーを使用しない通知メッセージでは 0 になります。
itemNewTVITEMA56/40+88+56変更後の項目の状態に関する情報を格納する TVITEM 構造体です。このメンバーを使用しない通知メッセージでは 0 になります。
ptDragPOINT8+144+96通知メッセージの送信要因となったイベントが発生した時点のマウスのクライアント座標を格納する POINT 構造体です。

公式ドキュメント

ツリービューの通知メッセージに関する情報を格納します。この構造体は NM_TREEVIEW 構造体と同一ですが、現在の命名規則に従うように名前が変更されています。

解説(Remarks)

メモ

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして NMTREEVIEW を定義しています。エンコードに依存しないエイリアスと、エンコードに依存するコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、関数プロトタイプの規則 を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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;

// TVITEMA  (x64 56 / x86 40 バイト)
typedef struct TVITEMA {
    TVITEM_MASK mask;
    HTREEITEM hItem;
    TREE_VIEW_ITEM_STATE_FLAGS state;
    TREE_VIEW_ITEM_STATE_FLAGS stateMask;
    LPSTR pszText;
    INT cchTextMax;
    INT iImage;
    INT iSelectedImage;
    TVITEMEXW_CHILDREN cChildren;
    LPARAM lParam;
} TVITEMA;

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

// NMTREEVIEWA  (x64 152 / x86 104 バイト)
typedef struct NMTREEVIEWA {
    NMHDR hdr;
    NM_TREEVIEW_ACTION action;
    TVITEMA itemOld;
    TVITEMA itemNew;
    POINT ptDrag;
} NMTREEVIEWA;
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 TVITEMA
{
    public uint mask;
    public IntPtr hItem;
    public uint state;
    public uint stateMask;
    public IntPtr pszText;
    public int cchTextMax;
    public int iImage;
    public int iSelectedImage;
    public int cChildren;
    public IntPtr lParam;
}

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

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMTREEVIEWA
{
    public NMHDR hdr;
    public uint action;
    public TVITEMA itemOld;
    public TVITEMA itemNew;
    public POINT ptDrag;
}
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 TVITEMA
    Public mask As UInteger
    Public hItem As IntPtr
    Public state As UInteger
    Public stateMask As UInteger
    Public pszText As IntPtr
    Public cchTextMax As Integer
    Public iImage As Integer
    Public iSelectedImage As Integer
    Public cChildren As Integer
    Public lParam As IntPtr
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 NMTREEVIEWA
    Public hdr As NMHDR
    Public action As UInteger
    Public itemOld As TVITEMA
    Public itemNew As TVITEMA
    Public ptDrag As POINT
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 TVITEMA(ctypes.Structure):
    _fields_ = [
        ("mask", wintypes.DWORD),
        ("hItem", ctypes.c_ssize_t),
        ("state", wintypes.DWORD),
        ("stateMask", wintypes.DWORD),
        ("pszText", ctypes.c_void_p),
        ("cchTextMax", ctypes.c_int),
        ("iImage", ctypes.c_int),
        ("iSelectedImage", ctypes.c_int),
        ("cChildren", ctypes.c_int),
        ("lParam", ctypes.c_ssize_t),
    ]

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

class NMTREEVIEWA(ctypes.Structure):
    _fields_ = [
        ("hdr", NMHDR),
        ("action", wintypes.DWORD),
        ("itemOld", TVITEMA),
        ("itemNew", TVITEMA),
        ("ptDrag", POINT),
    ]
#[repr(C)]
pub struct NMHDR {
    pub hwndFrom: *mut core::ffi::c_void,
    pub idFrom: usize,
    pub code: u32,
}

#[repr(C)]
pub struct TVITEMA {
    pub mask: u32,
    pub hItem: isize,
    pub state: u32,
    pub stateMask: u32,
    pub pszText: *mut core::ffi::c_void,
    pub cchTextMax: i32,
    pub iImage: i32,
    pub iSelectedImage: i32,
    pub cChildren: i32,
    pub lParam: isize,
}

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

#[repr(C)]
pub struct NMTREEVIEWA {
    pub hdr: NMHDR,
    pub action: u32,
    pub itemOld: TVITEMA,
    pub itemNew: TVITEMA,
    pub ptDrag: POINT,
}
import "golang.org/x/sys/windows"

type NMHDR struct {
	hwndFrom uintptr
	idFrom uintptr
	code uint32
}

type TVITEMA struct {
	mask uint32
	hItem uintptr
	state uint32
	stateMask uint32
	pszText uintptr
	cchTextMax int32
	iImage int32
	iSelectedImage int32
	cChildren int32
	lParam uintptr
}

type POINT struct {
	x int32
	y int32
}

type NMTREEVIEWA struct {
	hdr NMHDR
	action uint32
	itemOld TVITEMA
	itemNew TVITEMA
	ptDrag POINT
}
type
  NMHDR = record
    hwndFrom: Pointer;
    idFrom: NativeUInt;
    code: DWORD;
  end;

  TVITEMA = record
    mask: DWORD;
    hItem: NativeInt;
    state: DWORD;
    stateMask: DWORD;
    pszText: Pointer;
    cchTextMax: Integer;
    iImage: Integer;
    iSelectedImage: Integer;
    cChildren: Integer;
    lParam: NativeInt;
  end;

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

  NMTREEVIEWA = record
    hdr: NMHDR;
    action: DWORD;
    itemOld: TVITEMA;
    itemNew: TVITEMA;
    ptDrag: POINT;
  end;
const NMHDR = extern struct {
    hwndFrom: ?*anyopaque,
    idFrom: usize,
    code: u32,
};

const TVITEMA = extern struct {
    mask: u32,
    hItem: isize,
    state: u32,
    stateMask: u32,
    pszText: ?*anyopaque,
    cchTextMax: i32,
    iImage: i32,
    iSelectedImage: i32,
    cChildren: i32,
    lParam: isize,
};

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

const NMTREEVIEWA = extern struct {
    hdr: NMHDR,
    action: u32,
    itemOld: TVITEMA,
    itemNew: TVITEMA,
    ptDrag: POINT,
};
type
  NMHDR {.bycopy.} = object
    hwndFrom: pointer
    idFrom: uint
    code: uint32

  TVITEMA {.bycopy.} = object
    mask: uint32
    hItem: int
    state: uint32
    stateMask: uint32
    pszText: pointer
    cchTextMax: int32
    iImage: int32
    iSelectedImage: int32
    cChildren: int32
    lParam: int

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

  NMTREEVIEWA {.bycopy.} = object
    hdr: NMHDR
    action: uint32
    itemOld: TVITEMA
    itemNew: TVITEMA
    ptDrag: POINT
struct NMHDR
{
    void* hwndFrom;
    size_t idFrom;
    uint code;
}

struct TVITEMA
{
    uint mask;
    ptrdiff_t hItem;
    uint state;
    uint stateMask;
    void* pszText;
    int cchTextMax;
    int iImage;
    int iSelectedImage;
    int cChildren;
    ptrdiff_t lParam;
}

struct POINT
{
    int x;
    int y;
}

struct NMTREEVIEWA
{
    NMHDR hdr;
    uint action;
    TVITEMA itemOld;
    TVITEMA itemNew;
    POINT ptDrag;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NMTREEVIEWA サイズ: 104 バイト(x86)
dim st, 26    ; 4byte整数×26(構造体サイズ 104 / 4 切り上げ)
; hdr : NMHDR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; action : NM_TREEVIEW_ACTION (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; itemOld : TVITEMA (+16, 40byte)  varptr(st)+16 を基点に操作(40byte:入れ子/配列)
; itemNew : TVITEMA (+56, 40byte)  varptr(st)+56 を基点に操作(40byte:入れ子/配列)
; ptDrag : POINT (+96, 8byte)  varptr(st)+96 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NMTREEVIEWA サイズ: 152 バイト(x64)
dim st, 38    ; 4byte整数×38(構造体サイズ 152 / 4 切り上げ)
; hdr : NMHDR (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; action : NM_TREEVIEW_ACTION (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; itemOld : TVITEMA (+32, 56byte)  varptr(st)+32 を基点に操作(56byte:入れ子/配列)
; itemNew : TVITEMA (+88, 56byte)  varptr(st)+88 を基点に操作(56byte:入れ子/配列)
; ptDrag : POINT (+144, 8byte)  varptr(st)+144 を基点に操作(8byte:入れ子/配列)
; ※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 TVITEMA
    #field int mask
    #field intptr hItem
    #field int state
    #field int stateMask
    #field intptr pszText
    #field int cchTextMax
    #field int iImage
    #field int iSelectedImage
    #field int cChildren
    #field intptr lParam
#endstruct

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

#defstruct global NMTREEVIEWA
    #field NMHDR hdr
    #field int action
    #field TVITEMA itemOld
    #field TVITEMA itemNew
    #field POINT ptDrag
#endstruct

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