ホーム › UI.Controls › NMTVASYNCDRAW
NMTVASYNCDRAW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| hdr | NMHDR | 24/12 | +0 | +0 | NMHDR 構造体です。 |
| pimldp | IMAGELISTDRAWPARAMS* | 8/4 | +24 | +12 | 描画に失敗した画像を記述する IMAGELISTDRAWPARAMS 構造体です。 |
| hr | HRESULT | 4 | +32 | +16 | 描画が失敗した理由を示す結果コードで、ILDRF_IMAGELOWQUALITY、ILDRF_OVERLAYLOWQUALITY、E_PENDING、S_OK のいずれかです。S_OK は、画像は存在するものの必要な画質ではないことを示します。 |
| hItem | HTREEITEM | 8/4 | +40 | +20 | 描画に失敗したツリー項目のハンドルです。 |
| lParam | LPARAM | 8/4 | +48 | +24 | hItem のデータです。これは、TVITEM 構造体で適切な mask を使用して TVM_GETITEM メッセージで取得される項目のデータと同じものです。このデータは親固有であり、親はツリー項目の識別に役立つ情報やその他の情報を格納できます。データは利便性のために lParam で提供されており、親が TVM_GETITEM メッセージを送信する必要はありません。 |
| dwRetFlags | DWORD | 4 | +56 | +28 | 送信側 (ツリービューコントロール) が戻り時に実行すべき動作です。値は次のいずれかのフラグでなければなりません。 |
| iRetImageIndex | INT | 4 | +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)
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 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 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: int32struct 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