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

NMTVASYNCDRAW

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

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

フィールド

フィールドサイズx64x86説明
hdrNMHDR24/12+0+0NMHDR 構造体です。
pimldpIMAGELISTDRAWPARAMS*8/4+24+12描画に失敗した画像を記述する IMAGELISTDRAWPARAMS 構造体です。
hrHRESULT4+32+16描画が失敗した理由を示す結果コードで、ILDRF_IMAGELOWQUALITYILDRF_OVERLAYLOWQUALITYE_PENDINGS_OK のいずれかです。S_OK は、画像は存在するものの必要な画質ではないことを示します。
hItemHTREEITEM8/4+40+20描画に失敗したツリー項目のハンドルです。
lParamLPARAM8/4+48+24hItem のデータです。これは、TVITEM 構造体で適切な mask を使用して TVM_GETITEM メッセージで取得される項目のデータと同じものです。このデータは親固有であり、親はツリー項目の識別に役立つ情報やその他の情報を格納できます。データは利便性のために lParam で提供されており、親が TVM_GETITEM メッセージを送信する必要はありません。
dwRetFlagsDWORD4+56+28

送信側 (ツリービューコントロール) が戻り時に実行すべき動作です。値は次のいずれかのフラグでなければなりません。

意味
ADRF_DRAWIMAGE
iRetImageIndex で指定された画像を描画します。
ADRF_DRAWSYNC
そのまま画像の描画を続行します。つまり、同期的に画像を抽出して描画します。コントロールが UI スレッド上にある場合、このフラグの使用は UI パフォーマンスの優先度が低いことを意味します。抽出時間は状況によって異なるため、抽出中は長時間にわたって UI が応答しなくなる可能性があります。
ADRF_DRAWNOTHING
画像を描画しません。
iRetImageIndexINT4+60+32イメージリスト内で描画する画像のインデックスです。dwRetFlags で ADRF_DRAWIMAGE が返された場合に使用されます。

公式ドキュメント

アイコンまたはオーバーレイのツリー項目の描画が失敗した理由の説明を格納します。この構造体は TVN_ASYNCDRAW 通知で送信されます。コントロールが実行すべき動作を示すには、dwRetFlags メンバーを設定します。画像が存在しない場合、つまりアイコン画像がまだ抽出されていない場合にも描画が失敗することがあります。

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

// NMTVASYNCDRAW  (x64 64 / x86 36 バイト)
typedef struct NMTVASYNCDRAW {
    NMHDR hdr;
    IMAGELISTDRAWPARAMS* pimldp;
    HRESULT hr;
    HTREEITEM hItem;
    LPARAM lParam;
    DWORD dwRetFlags;
    INT iRetImageIndex;
} NMTVASYNCDRAW;
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 NMTVASYNCDRAW
{
    public NMHDR hdr;
    public IntPtr pimldp;
    public int hr;
    public IntPtr hItem;
    public IntPtr lParam;
    public uint dwRetFlags;
    public int iRetImageIndex;
}
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 NMTVASYNCDRAW
    Public hdr As NMHDR
    Public pimldp As IntPtr
    Public hr As Integer
    Public hItem As IntPtr
    Public lParam As IntPtr
    Public dwRetFlags As UInteger
    Public iRetImageIndex As Integer
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 NMTVASYNCDRAW(ctypes.Structure):
    _fields_ = [
        ("hdr", NMHDR),
        ("pimldp", ctypes.c_void_p),
        ("hr", ctypes.c_int),
        ("hItem", ctypes.c_ssize_t),
        ("lParam", ctypes.c_ssize_t),
        ("dwRetFlags", wintypes.DWORD),
        ("iRetImageIndex", ctypes.c_int),
    ]
#[repr(C)]
pub struct NMHDR {
    pub hwndFrom: *mut core::ffi::c_void,
    pub idFrom: usize,
    pub code: u32,
}

#[repr(C)]
pub struct NMTVASYNCDRAW {
    pub hdr: NMHDR,
    pub pimldp: *mut core::ffi::c_void,
    pub hr: i32,
    pub hItem: isize,
    pub lParam: isize,
    pub dwRetFlags: u32,
    pub iRetImageIndex: i32,
}
import "golang.org/x/sys/windows"

type NMHDR struct {
	hwndFrom uintptr
	idFrom uintptr
	code uint32
}

type NMTVASYNCDRAW struct {
	hdr NMHDR
	pimldp uintptr
	hr int32
	hItem uintptr
	lParam uintptr
	dwRetFlags uint32
	iRetImageIndex int32
}
type
  NMHDR = record
    hwndFrom: Pointer;
    idFrom: NativeUInt;
    code: DWORD;
  end;

  NMTVASYNCDRAW = record
    hdr: NMHDR;
    pimldp: Pointer;
    hr: Integer;
    hItem: NativeInt;
    lParam: NativeInt;
    dwRetFlags: DWORD;
    iRetImageIndex: Integer;
  end;
const NMHDR = extern struct {
    hwndFrom: ?*anyopaque,
    idFrom: usize,
    code: u32,
};

const NMTVASYNCDRAW = extern struct {
    hdr: NMHDR,
    pimldp: ?*anyopaque,
    hr: i32,
    hItem: isize,
    lParam: isize,
    dwRetFlags: u32,
    iRetImageIndex: i32,
};
type
  NMHDR {.bycopy.} = object
    hwndFrom: pointer
    idFrom: uint
    code: uint32

  NMTVASYNCDRAW {.bycopy.} = object
    hdr: NMHDR
    pimldp: pointer
    hr: int32
    hItem: int
    lParam: int
    dwRetFlags: uint32
    iRetImageIndex: int32
struct NMHDR
{
    void* hwndFrom;
    size_t idFrom;
    uint code;
}

struct NMTVASYNCDRAW
{
    NMHDR hdr;
    void* pimldp;
    int hr;
    ptrdiff_t hItem;
    ptrdiff_t lParam;
    uint dwRetFlags;
    int iRetImageIndex;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NMTVASYNCDRAW サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; hdr : NMHDR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; pimldp : IMAGELISTDRAWPARAMS* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; hr : HRESULT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; hItem : HTREEITEM (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lParam : LPARAM (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwRetFlags : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; iRetImageIndex : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NMTVASYNCDRAW サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; hdr : NMHDR (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; pimldp : IMAGELISTDRAWPARAMS* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; hr : HRESULT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; hItem : HTREEITEM (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lParam : LPARAM (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; dwRetFlags : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; iRetImageIndex : INT (+60, 4byte)  st.15 = 値  /  値 = st.15   (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 NMTVASYNCDRAW
    #field NMHDR hdr
    #field intptr pimldp
    #field int hr
    #field intptr hItem
    #field intptr lParam
    #field int dwRetFlags
    #field int iRetImageIndex
#endstruct

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