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

IMAGELISTDRAWPARAMS

構造体
サイズx64: 88 バイト / x86: 68 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ(バイト単位)。
himlHIMAGELIST8/4+8+4描画するイメージを含むイメージリストへのハンドル。
iINT4+16+8描画するイメージの 0 から始まるインデックス。
hdcDstHDC8/4+24+12描画先デバイスコンテキストへのハンドル。
xINT4+32+16イメージを描画する位置を指定する x 座標。
yINT4+36+20イメージを描画する位置を指定する y 座標。
cxINT4+40+24xBitmapyBitmap で指定される描画操作の左上隅を基準として、描画するピクセル数を指定します。cxcy が 0 の場合、Draw は有効な領域全体を描画します。このメソッドはパラメーターが有効であることを保証しません。
cyINT4+44+28xBitmapyBitmap で指定される描画操作の左上隅を基準として、描画するピクセル数を指定します。cxcy が 0 の場合、Draw は有効な領域全体を描画します。このメソッドはパラメーターが有効であることを保証しません。
xBitmapINT4+48+32イメージ自体を基準として、描画操作の左上隅を指定する x 座標。xBitmap より左、および yBitmap より上にあるイメージのピクセルは表示されません。
yBitmapINT4+52+36イメージ自体を基準として、描画操作の左上隅を指定する y 座標。xBitmap より左、および yBitmap より上にあるイメージのピクセルは表示されません。
rgbBkCOLORREF4+56+40

イメージの背景色。このパラメーターには、アプリケーションが定義する RGB 値、または次のいずれかの値を指定できます。

意味
CLR_DEFAULT
既定の背景色です。イメージはイメージリストの背景色を使用して描画されます。
CLR_NONE
背景色なし。イメージは透過して描画されます。
rgbFgCOLORREF4+60+44

イメージの前景色。このメンバーは、fStyleILD_BLEND25 または ILD_BLEND50 フラグが含まれている場合にのみ使用されます。このパラメーターには、アプリケーションが定義する RGB 値、または次のいずれかの値を指定できます。

意味
CLR_DEFAULT
既定の前景色です。イメージはシステムの強調表示色を前景色として使用して描画されます。
CLR_NONE
ブレンド色なし。イメージは描画先デバイスコンテキストの色とブレンドされます。
fStyleDWORD4+64+48描画スタイルと、必要に応じてオーバーレイイメージを指定するフラグ。オーバーレイイメージについては、このトピックの末尾にある解説を参照してください。このメンバーには、1 つ以上の イメージリスト描画フラグ を指定できます。
dwRopDWORD4+68+52

ラスター操作コードを指定する値。これらのコードは、最終的な色を得るために、コピー元の四角形の色データを描画先の四角形の色データとどのように組み合わせるかを定義します。このメンバーは、fStyleILD_ROP フラグが含まれていない場合は無視されます。一般的なラスター操作コードには次のものがあります。

意味
BLACKNESS
物理パレットのインデックス 0 に関連付けられた色を使用して、描画先の四角形を塗りつぶします。(既定の物理パレットでは、この色は黒です。)
DSTINVERT
描画先の四角形を反転します。
MERGECOPY
ブール演算子 AND を使用して、コピー元の四角形の色を指定されたパターンとマージします。
MERGEPAINT
ブール演算子 OR を使用して、反転したコピー元の四角形の色を描画先の四角形の色とマージします。
NOTSRCCOPY
反転したコピー元の四角形を描画先にコピーします。
NOTSRCERASE
ブール演算子 OR を使用して、コピー元と描画先の四角形の色を結合します。結果の色は反転されます。
PATCOPY
指定されたパターンを描画先のビットマップにコピーします。
PATINVERT
ブール演算子 XOR を使用して、指定されたパターンの色を描画先の四角形の色と結合します。
PATPAINT
ブール演算子 OR を使用して、パターンの色を反転したコピー元の四角形の色と結合し、その結果を描画先の四角形の色と結合します。
SRCAND
ブール演算子 AND を使用して、コピー元と描画先の四角形の色を結合します。
SRCCOPY
コピー元の四角形を描画先の四角形に直接コピーします。
SRCERASE
ブール演算子 AND を使用して、描画先の四角形の反転した色をコピー元の四角形の色と結合します。
SRCINVERT
ブール演算子 XOR を使用して、コピー元と描画先の四角形の色を結合します。
SRCPAINT
ブール演算子 OR を使用して、コピー元と描画先の四角形の色を結合します。
WHITENESS
物理パレットのインデックス 1 に関連付けられた色を使用して、描画先の四角形を塗りつぶします。既定の物理パレットでは、この色は白です。
fStateDWORD4+72+56描画状態を指定するフラグ。このメンバーには、1 つ以上の イメージリスト状態フラグ を指定できます。このメンバーを使用するには、comctl32.dll バージョン 6 を使用する必要があります。解説を参照してください。
FrameDWORD4+76+60

アルファブレンド 効果とともに使用されます。

ILS_ALPHA とともに使用する場合、このメンバーはアルファチャンネルの値を保持します。この値は 0 から 255 までで、0 は完全に透明、255 は完全に不透明を表します。

このメンバーを使用するには、comctl32.dll バージョン 6 を使用する必要があります。解説を参照してください。

crEffectCOLORREF4+80+64グロー 効果および シャドウ 効果に使用される色。このメンバーを使用するには、comctl32.dll バージョン 6 を使用する必要があります。解説を参照してください。

公式ドキュメント

イメージリストの描画操作に関する情報を格納します。IImageList::Draw 関数で使用されます。

解説(Remarks)

オーバーレイイメージとは、この構造体の i メンバーで指定されたプライマリイメージの上に描画されるイメージです。オーバーレイイメージを指定するには、ビット単位のOR演算子を使用して fStyleINDEXTOOVERLAYMASK マクロを組み合わせ、そのマクロにオーバーレイイメージの 1 から始まるインデックスを渡します。このイメージは、あらかじめ ImageList_SetOverlayImage API を使用してオーバーレイイメージとして指定されている必要があります。

fStyle からオーバーレイイメージを取り出すには、ビット単位のAND演算子を使用して fStyleILD_OVERLAYMASK 値でマスクします。

Comctl32.dll バージョン 6 は再頒布できません。Comctl32.dll バージョン 6 を使用するには、マニフェストで指定する必要があります。マニフェストの詳細については、ビジュアルスタイルの有効化 を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// IMAGELISTDRAWPARAMS  (x64 88 / x86 68 バイト)
typedef struct IMAGELISTDRAWPARAMS {
    DWORD cbSize;
    HIMAGELIST himl;
    INT i;
    HDC hdcDst;
    INT x;
    INT y;
    INT cx;
    INT cy;
    INT xBitmap;
    INT yBitmap;
    COLORREF rgbBk;
    COLORREF rgbFg;
    DWORD fStyle;
    DWORD dwRop;
    DWORD fState;
    DWORD Frame;
    COLORREF crEffect;
} IMAGELISTDRAWPARAMS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct IMAGELISTDRAWPARAMS
{
    public uint cbSize;
    public IntPtr himl;
    public int i;
    public IntPtr hdcDst;
    public int x;
    public int y;
    public int cx;
    public int cy;
    public int xBitmap;
    public int yBitmap;
    public uint rgbBk;
    public uint rgbFg;
    public uint fStyle;
    public uint dwRop;
    public uint fState;
    public uint Frame;
    public uint crEffect;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure IMAGELISTDRAWPARAMS
    Public cbSize As UInteger
    Public himl As IntPtr
    Public i As Integer
    Public hdcDst As IntPtr
    Public x As Integer
    Public y As Integer
    Public cx As Integer
    Public cy As Integer
    Public xBitmap As Integer
    Public yBitmap As Integer
    Public rgbBk As UInteger
    Public rgbFg As UInteger
    Public fStyle As UInteger
    Public dwRop As UInteger
    Public fState As UInteger
    Public Frame As UInteger
    Public crEffect As UInteger
End Structure
import ctypes
from ctypes import wintypes

class IMAGELISTDRAWPARAMS(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("himl", ctypes.c_ssize_t),
        ("i", ctypes.c_int),
        ("hdcDst", ctypes.c_void_p),
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
        ("cx", ctypes.c_int),
        ("cy", ctypes.c_int),
        ("xBitmap", ctypes.c_int),
        ("yBitmap", ctypes.c_int),
        ("rgbBk", wintypes.DWORD),
        ("rgbFg", wintypes.DWORD),
        ("fStyle", wintypes.DWORD),
        ("dwRop", wintypes.DWORD),
        ("fState", wintypes.DWORD),
        ("Frame", wintypes.DWORD),
        ("crEffect", wintypes.DWORD),
    ]
#[repr(C)]
pub struct IMAGELISTDRAWPARAMS {
    pub cbSize: u32,
    pub himl: isize,
    pub i: i32,
    pub hdcDst: *mut core::ffi::c_void,
    pub x: i32,
    pub y: i32,
    pub cx: i32,
    pub cy: i32,
    pub xBitmap: i32,
    pub yBitmap: i32,
    pub rgbBk: u32,
    pub rgbFg: u32,
    pub fStyle: u32,
    pub dwRop: u32,
    pub fState: u32,
    pub Frame: u32,
    pub crEffect: u32,
}
import "golang.org/x/sys/windows"

type IMAGELISTDRAWPARAMS struct {
	cbSize uint32
	himl uintptr
	i int32
	hdcDst uintptr
	x int32
	y int32
	cx int32
	cy int32
	xBitmap int32
	yBitmap int32
	rgbBk uint32
	rgbFg uint32
	fStyle uint32
	dwRop uint32
	fState uint32
	Frame uint32
	crEffect uint32
}
type
  IMAGELISTDRAWPARAMS = record
    cbSize: DWORD;
    himl: NativeInt;
    i: Integer;
    hdcDst: Pointer;
    x: Integer;
    y: Integer;
    cx: Integer;
    cy: Integer;
    xBitmap: Integer;
    yBitmap: Integer;
    rgbBk: DWORD;
    rgbFg: DWORD;
    fStyle: DWORD;
    dwRop: DWORD;
    fState: DWORD;
    Frame: DWORD;
    crEffect: DWORD;
  end;
const IMAGELISTDRAWPARAMS = extern struct {
    cbSize: u32,
    himl: isize,
    i: i32,
    hdcDst: ?*anyopaque,
    x: i32,
    y: i32,
    cx: i32,
    cy: i32,
    xBitmap: i32,
    yBitmap: i32,
    rgbBk: u32,
    rgbFg: u32,
    fStyle: u32,
    dwRop: u32,
    fState: u32,
    Frame: u32,
    crEffect: u32,
};
type
  IMAGELISTDRAWPARAMS {.bycopy.} = object
    cbSize: uint32
    himl: int
    i: int32
    hdcDst: pointer
    x: int32
    y: int32
    cx: int32
    cy: int32
    xBitmap: int32
    yBitmap: int32
    rgbBk: uint32
    rgbFg: uint32
    fStyle: uint32
    dwRop: uint32
    fState: uint32
    Frame: uint32
    crEffect: uint32
struct IMAGELISTDRAWPARAMS
{
    uint cbSize;
    ptrdiff_t himl;
    int i;
    void* hdcDst;
    int x;
    int y;
    int cx;
    int cy;
    int xBitmap;
    int yBitmap;
    uint rgbBk;
    uint rgbFg;
    uint fStyle;
    uint dwRop;
    uint fState;
    uint Frame;
    uint crEffect;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; IMAGELISTDRAWPARAMS サイズ: 68 バイト(x86)
dim st, 17    ; 4byte整数×17(構造体サイズ 68 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; himl : HIMAGELIST (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; i : INT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; hdcDst : HDC (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; x : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; y : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; cx : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; cy : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; xBitmap : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; yBitmap : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; rgbBk : COLORREF (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; rgbFg : COLORREF (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; fStyle : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwRop : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; fState : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; Frame : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; crEffect : COLORREF (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; IMAGELISTDRAWPARAMS サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; himl : HIMAGELIST (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; i : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; hdcDst : HDC (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; x : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; y : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; cx : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; cy : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; xBitmap : INT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; yBitmap : INT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; rgbBk : COLORREF (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; rgbFg : COLORREF (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; fStyle : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwRop : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; fState : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; Frame : DWORD (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; crEffect : COLORREF (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global IMAGELISTDRAWPARAMS
    #field int cbSize
    #field intptr himl
    #field int i
    #field intptr hdcDst
    #field int x
    #field int y
    #field int cx
    #field int cy
    #field int xBitmap
    #field int yBitmap
    #field int rgbBk
    #field int rgbFg
    #field int fStyle
    #field int dwRop
    #field int fState
    #field int Frame
    #field int crEffect
#endstruct

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