NMLVDISPINFOA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| hdr | NMHDR | 24/12 | +0 | +0 | この通知コードに関する情報を格納する NMHDR 構造体です。 |
| item | LVITEMA | 88/60 | +24 | +12 | 項目またはサブ項目を識別する LVITEM 構造体です。この構造体は、項目に関する情報を格納しているか、または受け取ります。mask メンバーには、どの項目属性が有効であるかを指定するビットフラグのセットが格納されます。 利用可能なビットフラグの詳細については、LVITEM を参照してください。 |
公式ドキュメント
LVN_GETDISPINFO または LVN_SETDISPINFO 通知コードに関する情報を格納します。この構造体は LV_DISPINFO 構造体と同じものですが、標準の命名規則に合わせて名称が変更されています。
解説(Remarks)
LVITEM 構造体が項目のテキストを受け取る場合、pszText メンバーと cchTextMax メンバーがバッファーのアドレスとサイズを指定します。バッファーにテキストをコピーするか、または文字列のアドレスを pszText メンバーに代入することができます。後者の場合、対応する項目のテキストが削除されるか、さらに 2 つの LVN_GETDISPINFO メッセージが送信されるまで、その文字列を変更したり削除したりしてはなりません。
LVN_GETDISPINFO メッセージを処理する場合、LVITEM 構造体の mask メンバーに LVIF_DI_SETITEM フラグを設定できます。これにより、要求されたリスト項目の情報を保存し、再度要求しないようオペレーティングシステムに指示します。LVS_REPORT スタイルを持つリストビューコントロールの場合、このフラグは最初の列 (サブ項目 0) の情報にのみ適用されます。コントロールはサブ項目の情報を保存しません。
commctrl.h ヘッダーは NMLVDISPINFO を、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立のエイリアスの使用を、エンコーディング中立でないコードと混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則 を参照してください。
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;
// LVITEMA (x64 88 / x86 60 バイト)
typedef struct LVITEMA {
LIST_VIEW_ITEM_FLAGS mask;
INT iItem;
INT iSubItem;
LIST_VIEW_ITEM_STATE_FLAGS state;
LIST_VIEW_ITEM_STATE_FLAGS stateMask;
LPSTR pszText;
INT cchTextMax;
INT iImage;
LPARAM lParam;
INT iIndent;
INT iGroupId;
DWORD cColumns;
DWORD* puColumns;
LIST_VIEW_ITEM_COLUMN_FORMAT_FLAGS* piColFmt;
INT iGroup;
} LVITEMA;
// NMLVDISPINFOA (x64 112 / x86 72 バイト)
typedef struct NMLVDISPINFOA {
NMHDR hdr;
LVITEMA item;
} NMLVDISPINFOA;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 LVITEMA
{
public uint mask;
public int iItem;
public int iSubItem;
public uint state;
public uint stateMask;
public IntPtr pszText;
public int cchTextMax;
public int iImage;
public IntPtr lParam;
public int iIndent;
public int iGroupId;
public uint cColumns;
public IntPtr puColumns;
public IntPtr piColFmt;
public int iGroup;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMLVDISPINFOA
{
public NMHDR hdr;
public LVITEMA item;
}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 LVITEMA
Public mask As UInteger
Public iItem As Integer
Public iSubItem As Integer
Public state As UInteger
Public stateMask As UInteger
Public pszText As IntPtr
Public cchTextMax As Integer
Public iImage As Integer
Public lParam As IntPtr
Public iIndent As Integer
Public iGroupId As Integer
Public cColumns As UInteger
Public puColumns As IntPtr
Public piColFmt As IntPtr
Public iGroup As Integer
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMLVDISPINFOA
Public hdr As NMHDR
Public item As LVITEMA
End Structureimport ctypes
from ctypes import wintypes
class NMHDR(ctypes.Structure):
_fields_ = [
("hwndFrom", ctypes.c_void_p),
("idFrom", ctypes.c_size_t),
("code", wintypes.DWORD),
]
class LVITEMA(ctypes.Structure):
_fields_ = [
("mask", wintypes.DWORD),
("iItem", ctypes.c_int),
("iSubItem", ctypes.c_int),
("state", wintypes.DWORD),
("stateMask", wintypes.DWORD),
("pszText", ctypes.c_void_p),
("cchTextMax", ctypes.c_int),
("iImage", ctypes.c_int),
("lParam", ctypes.c_ssize_t),
("iIndent", ctypes.c_int),
("iGroupId", ctypes.c_int),
("cColumns", wintypes.DWORD),
("puColumns", ctypes.c_void_p),
("piColFmt", ctypes.c_void_p),
("iGroup", ctypes.c_int),
]
class NMLVDISPINFOA(ctypes.Structure):
_fields_ = [
("hdr", NMHDR),
("item", LVITEMA),
]#[repr(C)]
pub struct NMHDR {
pub hwndFrom: *mut core::ffi::c_void,
pub idFrom: usize,
pub code: u32,
}
#[repr(C)]
pub struct LVITEMA {
pub mask: u32,
pub iItem: i32,
pub iSubItem: i32,
pub state: u32,
pub stateMask: u32,
pub pszText: *mut core::ffi::c_void,
pub cchTextMax: i32,
pub iImage: i32,
pub lParam: isize,
pub iIndent: i32,
pub iGroupId: i32,
pub cColumns: u32,
pub puColumns: *mut core::ffi::c_void,
pub piColFmt: *mut core::ffi::c_void,
pub iGroup: i32,
}
#[repr(C)]
pub struct NMLVDISPINFOA {
pub hdr: NMHDR,
pub item: LVITEMA,
}import "golang.org/x/sys/windows"
type NMHDR struct {
hwndFrom uintptr
idFrom uintptr
code uint32
}
type LVITEMA struct {
mask uint32
iItem int32
iSubItem int32
state uint32
stateMask uint32
pszText uintptr
cchTextMax int32
iImage int32
lParam uintptr
iIndent int32
iGroupId int32
cColumns uint32
puColumns uintptr
piColFmt uintptr
iGroup int32
}
type NMLVDISPINFOA struct {
hdr NMHDR
item LVITEMA
}type
NMHDR = record
hwndFrom: Pointer;
idFrom: NativeUInt;
code: DWORD;
end;
LVITEMA = record
mask: DWORD;
iItem: Integer;
iSubItem: Integer;
state: DWORD;
stateMask: DWORD;
pszText: Pointer;
cchTextMax: Integer;
iImage: Integer;
lParam: NativeInt;
iIndent: Integer;
iGroupId: Integer;
cColumns: DWORD;
puColumns: Pointer;
piColFmt: Pointer;
iGroup: Integer;
end;
NMLVDISPINFOA = record
hdr: NMHDR;
item: LVITEMA;
end;const NMHDR = extern struct {
hwndFrom: ?*anyopaque,
idFrom: usize,
code: u32,
};
const LVITEMA = extern struct {
mask: u32,
iItem: i32,
iSubItem: i32,
state: u32,
stateMask: u32,
pszText: ?*anyopaque,
cchTextMax: i32,
iImage: i32,
lParam: isize,
iIndent: i32,
iGroupId: i32,
cColumns: u32,
puColumns: ?*anyopaque,
piColFmt: ?*anyopaque,
iGroup: i32,
};
const NMLVDISPINFOA = extern struct {
hdr: NMHDR,
item: LVITEMA,
};type
NMHDR {.bycopy.} = object
hwndFrom: pointer
idFrom: uint
code: uint32
LVITEMA {.bycopy.} = object
mask: uint32
iItem: int32
iSubItem: int32
state: uint32
stateMask: uint32
pszText: pointer
cchTextMax: int32
iImage: int32
lParam: int
iIndent: int32
iGroupId: int32
cColumns: uint32
puColumns: pointer
piColFmt: pointer
iGroup: int32
NMLVDISPINFOA {.bycopy.} = object
hdr: NMHDR
item: LVITEMAstruct NMHDR
{
void* hwndFrom;
size_t idFrom;
uint code;
}
struct LVITEMA
{
uint mask;
int iItem;
int iSubItem;
uint state;
uint stateMask;
void* pszText;
int cchTextMax;
int iImage;
ptrdiff_t lParam;
int iIndent;
int iGroupId;
uint cColumns;
void* puColumns;
void* piColFmt;
int iGroup;
}
struct NMLVDISPINFOA
{
NMHDR hdr;
LVITEMA item;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NMLVDISPINFOA サイズ: 72 バイト(x86)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; hdr : NMHDR (+0, 12byte) varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; item : LVITEMA (+12, 60byte) varptr(st)+12 を基点に操作(60byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NMLVDISPINFOA サイズ: 112 バイト(x64)
dim st, 28 ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; hdr : NMHDR (+0, 24byte) varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; item : LVITEMA (+24, 88byte) varptr(st)+24 を基点に操作(88byte:入れ子/配列)
; ※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 LVITEMA
#field int mask
#field int iItem
#field int iSubItem
#field int state
#field int stateMask
#field intptr pszText
#field int cchTextMax
#field int iImage
#field intptr lParam
#field int iIndent
#field int iGroupId
#field int cColumns
#field intptr puColumns
#field intptr piColFmt
#field int iGroup
#endstruct
#defstruct global NMLVDISPINFOA
#field NMHDR hdr
#field LVITEMA item
#endstruct
stdim st, NMLVDISPINFOA ; NSTRUCT 変数を確保