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

DRAWITEMSTRUCT

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

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

フィールド

フィールドサイズx64x86説明
CtlTypeDRAWITEMSTRUCT_CTL_TYPE4+0+0

コントロールの種類です。このメンバーには次のいずれかの値を指定できます。解説を参照してください。

意味
ODT_BUTTON
オーナー描画のボタン
ODT_COMBOBOX
オーナー描画のコンボボックス
ODT_LISTBOX
オーナー描画のリストボックス
ODT_LISTVIEW
リストビューコントロール
ODT_MENU
オーナー描画のメニュー項目
ODT_STATIC
オーナー描画のスタティックコントロール
ODT_TAB
タブコントロール
CtlIDDWORD4+4+4コンボボックス、リストボックス、ボタン、またはスタティックコントロールの識別子です。このメンバーはメニュー項目では使用されません。
itemIDDWORD4+8+8メニュー項目の場合はメニュー項目の識別子、リストボックスまたはコンボボックスの場合は項目のインデックスです。空のリストボックスまたはコンボボックスの場合、このメンバーは -1 になることがあります。これにより、コントロールに項目が 1 つも無い場合でも、アプリケーションは rcItem メンバーで指定された座標にフォーカス矩形だけを描画できます。これによって、リストボックスまたはコンボボックスがフォーカスを持っているかどうかをユーザーに示します。リストボックスまたはコンボボックスがフォーカスを持っているものとして矩形を描画するかどうかは、itemAction メンバーのビットの設定によって決まります。
itemActionODA_FLAGS4+12+12

必要な描画動作です。このメンバーには次の値の 1 つ以上を指定できます。

意味
ODA_DRAWENTIRE
コントロール全体を描画する必要があります。
ODA_FOCUS
コントロールがキーボードフォーカスを失った、または取得しました。コントロールがフォーカスを持っているかどうかを判断するには、itemState メンバーを確認してください。
ODA_SELECT
選択状態が変化しました。新しい選択状態を判断するには、itemState メンバーを確認してください。
itemStateODS_FLAGS4+16+16

現在の描画動作が行われた後の項目の表示状態です。このメンバーには、次の表に示す値の組み合わせを指定できます。

意味
ODS_CHECKED
メニュー項目にチェックを付けます。このビットはメニューでのみ使用されます。
ODS_COMBOBOXEDIT
オーナー描画のコンボボックスの選択フィールド (エディットコントロール) で描画が行われます。
ODS_DEFAULT
この項目は既定の項目です。
ODS_DISABLED
項目を無効状態として描画します。
ODS_FOCUS
項目がキーボードフォーカスを持っています。
ODS_GRAYED
項目をグレー表示にします。このビットはメニューでのみ使用されます。
ODS_HOTLIGHT
項目はホットトラッキングされています。つまり、マウスポインターが項目上にあるときに項目が強調表示されます。
ODS_INACTIVE
項目は非アクティブであり、メニューに関連付けられているウィンドウも非アクティブです。
ODS_NOACCEL
コントロールはキーボードアクセラレーターの視覚的な手がかりを表示せずに描画されます。
ODS_NOFOCUSRECT
コントロールはフォーカスインジケーターの視覚的な手がかりを表示せずに描画されます。
ODS_SELECTED
メニュー項目の状態は選択済みです。
hwndItemHWND8/4+24+20コンボボックス、リストボックス、ボタン、およびスタティックコントロールの場合は、コントロールへのハンドルです。メニューの場合、このメンバーは項目を含むメニューへのハンドルです。
hDCHDC8/4+32+24デバイスコンテキストへのハンドルです。コントロールに対して描画操作を行うときは、このデバイスコンテキストを使用しなければなりません。
rcItemRECT16+40+28描画対象のコントロールの境界を定義する矩形です。この矩形は、hDC メンバーで指定されたデバイスコンテキスト内のものです。システムは、コンボボックス、リストボックス、およびボタンについては、オーナーウィンドウがデバイスコンテキストに描画した内容を自動的にクリップしますが、メニュー項目についてはクリップしません。メニュー項目を描画する場合、オーナーウィンドウは rcItem メンバーで定義された矩形の境界の外側に描画してはなりません。
itemDataUINT_PTR8/4+56+44

メニュー項目に関連付けられた、アプリケーション定義の値です。コントロールの場合、このパラメーターは、LB_SETITEMDATA メッセージまたは CB_SETITEMDATA メッセージによってリストボックスまたはコンボボックスに最後に割り当てられた値を指定します。リストボックスまたはコンボボックスに LBS_HASSTRINGS スタイルまたは CBS_HASSTRINGS スタイルが設定されている場合、この値の初期値は 0 です。それ以外の場合、この値の初期値は、次のいずれかのメッセージの lParam パラメーターでリストボックスまたはコンボボックスに渡された値です。

CtlTypeODT_BUTTON または ODT_STATIC の場合、itemData は 0 です。

公式ドキュメント

オーナーウィンドウが、オーナー描画コントロールまたはメニュー項目をどのように描画するかを判断するために使用する情報を提供します。オーナー描画コントロールまたはメニュー項目のオーナーウィンドウは、WM_DRAWITEM メッセージの lParam パラメーターとして、この構造体へのポインターを受け取ります。

解説(Remarks)

ステータスバーなど、一部のコントロールの種類では CtlType の値が設定されません。

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

各言語での定義

#include <windows.h>

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

// DRAWITEMSTRUCT  (x64 64 / x86 48 バイト)
typedef struct DRAWITEMSTRUCT {
    DRAWITEMSTRUCT_CTL_TYPE CtlType;
    DWORD CtlID;
    DWORD itemID;
    ODA_FLAGS itemAction;
    ODS_FLAGS itemState;
    HWND hwndItem;
    HDC hDC;
    RECT rcItem;
    UINT_PTR itemData;
} DRAWITEMSTRUCT;
using System;
using System.Runtime.InteropServices;

[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 DRAWITEMSTRUCT
{
    public uint CtlType;
    public uint CtlID;
    public uint itemID;
    public uint itemAction;
    public uint itemState;
    public IntPtr hwndItem;
    public IntPtr hDC;
    public RECT rcItem;
    public UIntPtr itemData;
}
Imports System.Runtime.InteropServices

<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 DRAWITEMSTRUCT
    Public CtlType As UInteger
    Public CtlID As UInteger
    Public itemID As UInteger
    Public itemAction As UInteger
    Public itemState As UInteger
    Public hwndItem As IntPtr
    Public hDC As IntPtr
    Public rcItem As RECT
    Public itemData As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class RECT(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_int),
        ("top", ctypes.c_int),
        ("right", ctypes.c_int),
        ("bottom", ctypes.c_int),
    ]

class DRAWITEMSTRUCT(ctypes.Structure):
    _fields_ = [
        ("CtlType", wintypes.DWORD),
        ("CtlID", wintypes.DWORD),
        ("itemID", wintypes.DWORD),
        ("itemAction", wintypes.DWORD),
        ("itemState", wintypes.DWORD),
        ("hwndItem", ctypes.c_void_p),
        ("hDC", ctypes.c_void_p),
        ("rcItem", RECT),
        ("itemData", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct RECT {
    pub left: i32,
    pub top: i32,
    pub right: i32,
    pub bottom: i32,
}

#[repr(C)]
pub struct DRAWITEMSTRUCT {
    pub CtlType: u32,
    pub CtlID: u32,
    pub itemID: u32,
    pub itemAction: u32,
    pub itemState: u32,
    pub hwndItem: *mut core::ffi::c_void,
    pub hDC: *mut core::ffi::c_void,
    pub rcItem: RECT,
    pub itemData: usize,
}
import "golang.org/x/sys/windows"

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

type DRAWITEMSTRUCT struct {
	CtlType uint32
	CtlID uint32
	itemID uint32
	itemAction uint32
	itemState uint32
	hwndItem uintptr
	hDC uintptr
	rcItem RECT
	itemData uintptr
}
type
  RECT = record
    left: Integer;
    top: Integer;
    right: Integer;
    bottom: Integer;
  end;

  DRAWITEMSTRUCT = record
    CtlType: DWORD;
    CtlID: DWORD;
    itemID: DWORD;
    itemAction: DWORD;
    itemState: DWORD;
    hwndItem: Pointer;
    hDC: Pointer;
    rcItem: RECT;
    itemData: NativeUInt;
  end;
const RECT = extern struct {
    left: i32,
    top: i32,
    right: i32,
    bottom: i32,
};

const DRAWITEMSTRUCT = extern struct {
    CtlType: u32,
    CtlID: u32,
    itemID: u32,
    itemAction: u32,
    itemState: u32,
    hwndItem: ?*anyopaque,
    hDC: ?*anyopaque,
    rcItem: RECT,
    itemData: usize,
};
type
  RECT {.bycopy.} = object
    left: int32
    top: int32
    right: int32
    bottom: int32

  DRAWITEMSTRUCT {.bycopy.} = object
    CtlType: uint32
    CtlID: uint32
    itemID: uint32
    itemAction: uint32
    itemState: uint32
    hwndItem: pointer
    hDC: pointer
    rcItem: RECT
    itemData: uint
struct RECT
{
    int left;
    int top;
    int right;
    int bottom;
}

struct DRAWITEMSTRUCT
{
    uint CtlType;
    uint CtlID;
    uint itemID;
    uint itemAction;
    uint itemState;
    void* hwndItem;
    void* hDC;
    RECT rcItem;
    size_t itemData;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DRAWITEMSTRUCT サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; CtlType : DRAWITEMSTRUCT_CTL_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; CtlID : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; itemID : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; itemAction : ODA_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; itemState : ODS_FLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; hwndItem : HWND (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; hDC : HDC (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; rcItem : RECT (+28, 16byte)  varptr(st)+28 を基点に操作(16byte:入れ子/配列)
; itemData : UINT_PTR (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DRAWITEMSTRUCT サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; CtlType : DRAWITEMSTRUCT_CTL_TYPE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; CtlID : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; itemID : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; itemAction : ODA_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; itemState : ODS_FLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; hwndItem : HWND (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; hDC : HDC (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; rcItem : RECT (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; itemData : UINT_PTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RECT
    #field int left
    #field int top
    #field int right
    #field int bottom
#endstruct

#defstruct global DRAWITEMSTRUCT
    #field int CtlType
    #field int CtlID
    #field int itemID
    #field int itemAction
    #field int itemState
    #field intptr hwndItem
    #field intptr hDC
    #field RECT rcItem
    #field intptr itemData
#endstruct

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