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

NMLVCUSTOMDRAW

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

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

フィールド

フィールドサイズx64x86説明
nmcdNMCUSTOMDRAW80/48+0+0基底となるカスタム描画情報を保持するNMCUSTOMDRAW構造体。
clrTextCOLORREF4+80+48項目テキストの色。COLORREF形式。
clrTextBkCOLORREF4+84+52項目テキストの背景色。COLORREF形式。
iSubItemINT4+88+56描画中のサブ項目(列)のインデックス。
dwItemTypeNMLVCUSTOMDRAW_ITEM_TYPE4+92+60描画中の項目の種類を示すLVCDI_系フラグ。
clrFaceCOLORREF4+96+64グループの背景色。COLORREF形式。
iIconEffectINT4+100+68アイコンに適用するエフェクトの識別子。
iIconPhaseINT4+104+72アイコンエフェクトのフェーズ。
iPartIdINT4+108+76ビジュアルスタイルのパート識別子。
iStateIdINT4+112+80ビジュアルスタイルの状態識別子。
rcTextRECT16+116+84テキスト描画矩形を表すRECT。
uAlignLIST_VIEW_GROUP_ALIGN_FLAGS4+132+100テキストの配置を示すフラグ。

各言語での定義

#include <windows.h>

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

// RECT  (x64 16 / x86 16 バイト)
typedef struct RECT {
    INT left;
    INT top;
    INT right;
    INT bottom;
} RECT;

// NMCUSTOMDRAW  (x64 80 / x86 48 バイト)
typedef struct NMCUSTOMDRAW {
    NMHDR hdr;
    NMCUSTOMDRAW_DRAW_STAGE dwDrawStage;
    HDC hdc;
    RECT rc;
    UINT_PTR dwItemSpec;
    NMCUSTOMDRAW_DRAW_STATE_FLAGS uItemState;
    LPARAM lItemlParam;
} NMCUSTOMDRAW;

// NMLVCUSTOMDRAW  (x64 136 / x86 104 バイト)
typedef struct NMLVCUSTOMDRAW {
    NMCUSTOMDRAW nmcd;
    COLORREF clrText;
    COLORREF clrTextBk;
    INT iSubItem;
    NMLVCUSTOMDRAW_ITEM_TYPE dwItemType;
    COLORREF clrFace;
    INT iIconEffect;
    INT iIconPhase;
    INT iPartId;
    INT iStateId;
    RECT rcText;
    LIST_VIEW_GROUP_ALIGN_FLAGS uAlign;
} NMLVCUSTOMDRAW;
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 RECT
{
    public int left;
    public int top;
    public int right;
    public int bottom;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMCUSTOMDRAW
{
    public NMHDR hdr;
    public uint dwDrawStage;
    public IntPtr hdc;
    public RECT rc;
    public UIntPtr dwItemSpec;
    public uint uItemState;
    public IntPtr lItemlParam;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMLVCUSTOMDRAW
{
    public NMCUSTOMDRAW nmcd;
    public uint clrText;
    public uint clrTextBk;
    public int iSubItem;
    public uint dwItemType;
    public uint clrFace;
    public int iIconEffect;
    public int iIconPhase;
    public int iPartId;
    public int iStateId;
    public RECT rcText;
    public uint uAlign;
}
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 RECT
    Public left As Integer
    Public top As Integer
    Public right As Integer
    Public bottom As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMCUSTOMDRAW
    Public hdr As NMHDR
    Public dwDrawStage As UInteger
    Public hdc As IntPtr
    Public rc As RECT
    Public dwItemSpec As UIntPtr
    Public uItemState As UInteger
    Public lItemlParam As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMLVCUSTOMDRAW
    Public nmcd As NMCUSTOMDRAW
    Public clrText As UInteger
    Public clrTextBk As UInteger
    Public iSubItem As Integer
    Public dwItemType As UInteger
    Public clrFace As UInteger
    Public iIconEffect As Integer
    Public iIconPhase As Integer
    Public iPartId As Integer
    Public iStateId As Integer
    Public rcText As RECT
    Public uAlign 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 RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class NMCUSTOMDRAW(ctypes.Structure):
    _fields_ = [
        ("hdr", NMHDR),
        ("dwDrawStage", wintypes.DWORD),
        ("hdc", ctypes.c_void_p),
        ("rc", RECT),
        ("dwItemSpec", ctypes.c_size_t),
        ("uItemState", wintypes.DWORD),
        ("lItemlParam", ctypes.c_ssize_t),
    ]

class NMLVCUSTOMDRAW(ctypes.Structure):
    _fields_ = [
        ("nmcd", NMCUSTOMDRAW),
        ("clrText", wintypes.DWORD),
        ("clrTextBk", wintypes.DWORD),
        ("iSubItem", ctypes.c_int),
        ("dwItemType", wintypes.DWORD),
        ("clrFace", wintypes.DWORD),
        ("iIconEffect", ctypes.c_int),
        ("iIconPhase", ctypes.c_int),
        ("iPartId", ctypes.c_int),
        ("iStateId", ctypes.c_int),
        ("rcText", RECT),
        ("uAlign", wintypes.DWORD),
    ]
#[repr(C)]
pub struct NMHDR {
    pub hwndFrom: *mut core::ffi::c_void,
    pub idFrom: usize,
    pub code: u32,
}

#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct NMCUSTOMDRAW {
    pub hdr: NMHDR,
    pub dwDrawStage: u32,
    pub hdc: *mut core::ffi::c_void,
    pub rc: RECT,
    pub dwItemSpec: usize,
    pub uItemState: u32,
    pub lItemlParam: isize,
}

#[repr(C)]
pub struct NMLVCUSTOMDRAW {
    pub nmcd: NMCUSTOMDRAW,
    pub clrText: u32,
    pub clrTextBk: u32,
    pub iSubItem: i32,
    pub dwItemType: u32,
    pub clrFace: u32,
    pub iIconEffect: i32,
    pub iIconPhase: i32,
    pub iPartId: i32,
    pub iStateId: i32,
    pub rcText: RECT,
    pub uAlign: u32,
}
import "golang.org/x/sys/windows"

type NMHDR struct {
	hwndFrom uintptr
	idFrom uintptr
	code uint32
}

type RECT struct {
	left int32
	top int32
	right int32
	bottom int32
}

type NMCUSTOMDRAW struct {
	hdr NMHDR
	dwDrawStage uint32
	hdc uintptr
	rc RECT
	dwItemSpec uintptr
	uItemState uint32
	lItemlParam uintptr
}

type NMLVCUSTOMDRAW struct {
	nmcd NMCUSTOMDRAW
	clrText uint32
	clrTextBk uint32
	iSubItem int32
	dwItemType uint32
	clrFace uint32
	iIconEffect int32
	iIconPhase int32
	iPartId int32
	iStateId int32
	rcText RECT
	uAlign uint32
}
type
  NMHDR = record
    hwndFrom: Pointer;
    idFrom: NativeUInt;
    code: DWORD;
  end;

  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  NMCUSTOMDRAW = record
    hdr: NMHDR;
    dwDrawStage: DWORD;
    hdc: Pointer;
    rc: RECT;
    dwItemSpec: NativeUInt;
    uItemState: DWORD;
    lItemlParam: NativeInt;
  end;

  NMLVCUSTOMDRAW = record
    nmcd: NMCUSTOMDRAW;
    clrText: DWORD;
    clrTextBk: DWORD;
    iSubItem: Integer;
    dwItemType: DWORD;
    clrFace: DWORD;
    iIconEffect: Integer;
    iIconPhase: Integer;
    iPartId: Integer;
    iStateId: Integer;
    rcText: RECT;
    uAlign: DWORD;
  end;
const NMHDR = extern struct {
    hwndFrom: ?*anyopaque,
    idFrom: usize,
    code: u32,
};

const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const NMCUSTOMDRAW = extern struct {
    hdr: NMHDR,
    dwDrawStage: u32,
    hdc: ?*anyopaque,
    rc: RECT,
    dwItemSpec: usize,
    uItemState: u32,
    lItemlParam: isize,
};

const NMLVCUSTOMDRAW = extern struct {
    nmcd: NMCUSTOMDRAW,
    clrText: u32,
    clrTextBk: u32,
    iSubItem: i32,
    dwItemType: u32,
    clrFace: u32,
    iIconEffect: i32,
    iIconPhase: i32,
    iPartId: i32,
    iStateId: i32,
    rcText: RECT,
    uAlign: u32,
};
type
  NMHDR {.bycopy.} = object
    hwndFrom: pointer
    idFrom: uint
    code: uint32

  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  NMCUSTOMDRAW {.bycopy.} = object
    hdr: NMHDR
    dwDrawStage: uint32
    hdc: pointer
    rc: RECT
    dwItemSpec: uint
    uItemState: uint32
    lItemlParam: int

  NMLVCUSTOMDRAW {.bycopy.} = object
    nmcd: NMCUSTOMDRAW
    clrText: uint32
    clrTextBk: uint32
    iSubItem: int32
    dwItemType: uint32
    clrFace: uint32
    iIconEffect: int32
    iIconPhase: int32
    iPartId: int32
    iStateId: int32
    rcText: RECT
    uAlign: uint32
struct NMHDR
{
    void* hwndFrom;
    size_t idFrom;
    uint code;
}

struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct NMCUSTOMDRAW
{
    NMHDR hdr;
    uint dwDrawStage;
    void* hdc;
    RECT rc;
    size_t dwItemSpec;
    uint uItemState;
    ptrdiff_t lItemlParam;
}

struct NMLVCUSTOMDRAW
{
    NMCUSTOMDRAW nmcd;
    uint clrText;
    uint clrTextBk;
    int iSubItem;
    uint dwItemType;
    uint clrFace;
    int iIconEffect;
    int iIconPhase;
    int iPartId;
    int iStateId;
    RECT rcText;
    uint uAlign;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NMLVCUSTOMDRAW サイズ: 104 バイト(x86)
dim st, 26    ; 4byte整数×26(構造体サイズ 104 / 4 切り上げ)
; nmcd : NMCUSTOMDRAW (+0, 48byte)  varptr(st)+0 を基点に操作(48byte:入れ子/配列)
; clrText : COLORREF (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; clrTextBk : COLORREF (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; iSubItem : INT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; dwItemType : NMLVCUSTOMDRAW_ITEM_TYPE (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; clrFace : COLORREF (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; iIconEffect : INT (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; iIconPhase : INT (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; iPartId : INT (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; iStateId : INT (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; rcText : RECT (+84, 16byte)  varptr(st)+84 を基点に操作(16byte:入れ子/配列)
; uAlign : LIST_VIEW_GROUP_ALIGN_FLAGS (+100, 4byte)  st.25 = 値  /  値 = st.25   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NMLVCUSTOMDRAW サイズ: 136 バイト(x64)
dim st, 34    ; 4byte整数×34(構造体サイズ 136 / 4 切り上げ)
; nmcd : NMCUSTOMDRAW (+0, 80byte)  varptr(st)+0 を基点に操作(80byte:入れ子/配列)
; clrText : COLORREF (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; clrTextBk : COLORREF (+84, 4byte)  st.21 = 値  /  値 = st.21   (lpoke/lpeek も可)
; iSubItem : INT (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; dwItemType : NMLVCUSTOMDRAW_ITEM_TYPE (+92, 4byte)  st.23 = 値  /  値 = st.23   (lpoke/lpeek も可)
; clrFace : COLORREF (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; iIconEffect : INT (+100, 4byte)  st.25 = 値  /  値 = st.25   (lpoke/lpeek も可)
; iIconPhase : INT (+104, 4byte)  st.26 = 値  /  値 = st.26   (lpoke/lpeek も可)
; iPartId : INT (+108, 4byte)  st.27 = 値  /  値 = st.27   (lpoke/lpeek も可)
; iStateId : INT (+112, 4byte)  st.28 = 値  /  値 = st.28   (lpoke/lpeek も可)
; rcText : RECT (+116, 16byte)  varptr(st)+116 を基点に操作(16byte:入れ子/配列)
; uAlign : LIST_VIEW_GROUP_ALIGN_FLAGS (+132, 4byte)  st.33 = 値  /  値 = st.33   (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 RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global NMCUSTOMDRAW
    #field NMHDR hdr
    #field int dwDrawStage
    #field intptr hdc
    #field RECT rc
    #field intptr dwItemSpec
    #field int uItemState
    #field intptr lItemlParam
#endstruct

#defstruct global NMLVCUSTOMDRAW
    #field NMCUSTOMDRAW nmcd
    #field int clrText
    #field int clrTextBk
    #field int iSubItem
    #field int dwItemType
    #field int clrFace
    #field int iIconEffect
    #field int iIconPhase
    #field int iPartId
    #field int iStateId
    #field RECT rcText
    #field int uAlign
#endstruct

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