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

CHOOSECOLORW

構造体
サイズx64: 60 バイト / x86: 36 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
lStructSizeDWORD4+0+0構造体の長さ (バイト単位)。
hwndOwnerHWND8/4+4+4ダイアログ ボックスを所有するウィンドウへのハンドル。このメンバーには任意の有効なウィンドウ ハンドルを指定できます。また、ダイアログ ボックスに所有者がない場合は NULL を指定できます。
hInstanceHWND8/4+12+8Flags メンバーに CC_ENABLETEMPLATEHANDLE フラグが設定されている場合、hInstance はダイアログ ボックス テンプレートを含むメモリ オブジェクトへのハンドルです。CC_ENABLETEMPLATE フラグが設定されている場合、hInstancelpTemplateName メンバーで指定された名前のダイアログ ボックス テンプレートを含むモジュールへのハンドルです。CC_ENABLETEMPLATEHANDLECC_ENABLETEMPLATE のどちらも設定されていない場合、このメンバーは無視されます。
rgbResultCOLORREF4+20+12CC_RGBINIT フラグが設定されている場合、rgbResult はダイアログ ボックスの作成時に最初に選択される色を指定します。指定した色の値が利用可能な色に含まれていない場合、システムは利用可能な最も近い純色を選択します。rgbResult が 0 の場合、または CC_RGBINIT が設定されていない場合、最初に選択される色は黒になります。ユーザーが OK ボタンをクリックすると、rgbResult にはユーザーが選択した色が格納されます。COLORREF の色の値を作成するには、RGB マクロを使用します。
lpCustColorsCOLORREF*8/4+24+16ダイアログ ボックスのカスタム カラー ボックスに使用する赤、緑、青 (RGB) の値を格納する、16 個の値の配列へのポインター。ユーザーがこれらの色を変更すると、システムは新しい RGB 値で配列を更新します。ChooseColor 関数の呼び出し間で新しいカスタム カラーを保持するには、この配列に静的メモリを割り当てる必要があります。COLORREF の色の値を作成するには、RGB マクロを使用します。
FlagsCHOOSECOLOR_FLAGS4+32+20

Color ダイアログ ボックスの初期化に使用できるビット フラグのセット。ダイアログ ボックスから制御が戻るとき、ユーザーの入力を示すためにこれらのフラグが設定されます。このメンバーには、次のフラグの組み合わせを指定できます。

意味
CC_ANYCOLOR
0x00000100
基本色のセットで利用可能なすべての色をダイアログ ボックスに表示します。
CC_ENABLEHOOK
0x00000010
この構造体の lpfnHook メンバーで指定されたフック プロシージャを有効にします。このフラグはダイアログ ボックスの初期化にのみ使用されます。
CC_ENABLETEMPLATE
0x00000020
hInstance メンバーと lpTemplateName メンバーが、既定のテンプレートの代わりに使用するダイアログ ボックス テンプレートを指定します。このフラグはダイアログ ボックスの初期化にのみ使用されます。
CC_ENABLETEMPLATEHANDLE
0x00000040
hInstance メンバーは、事前に読み込まれたダイアログ ボックス テンプレートを含むデータ ブロックを識別します。このフラグが指定されている場合、システムは lpTemplateName メンバーを無視します。このフラグはダイアログ ボックスの初期化にのみ使用されます。
CC_FULLOPEN
0x00000002
ユーザーがカスタム カラーを作成するための追加のコントロールをダイアログ ボックスに表示します。このフラグが設定されていない場合、カスタム カラーのコントロールを表示するには、ユーザーが 色の作成 ボタンをクリックする必要があります。
CC_PREVENTFULLOPEN
0x00000004
色の作成 ボタンを無効にします。
CC_RGBINIT
0x00000001
rgbResult メンバーで指定された色を最初に選択される色として使用するようにダイアログ ボックスに指示します。
CC_SHOWHELP
0x00000008
ダイアログ ボックスにヘルプ ボタンを表示します。hwndOwner メンバーには、ユーザーが ヘルプ ボタンをクリックしたときにダイアログ ボックスが送信する HELPMSGSTRING 登録メッセージを受け取るウィンドウを指定する必要があります。
CC_SOLIDCOLOR
0x00000080
基本色のセットに純色のみをダイアログ ボックスに表示します。
lCustDataLPARAM8/4+36+24lpfnHook メンバーで識別されるフック プロシージャにシステムが渡す、アプリケーション定義のデータ。システムがフック プロシージャに WM_INITDIALOG メッセージを送信するとき、メッセージの lParam パラメーターは、ダイアログ ボックスの作成時に指定された CHOOSECOLOR 構造体へのポインターです。フック プロシージャはこのポインターを使用して lCustData の値を取得できます。
lpfnHookLPCCHOOKPROC8/4+44+28ダイアログ ボックス宛てのメッセージを処理できる CCHookProc フック プロシージャへのポインター。このメンバーは、Flags メンバーに CC_ENABLEHOOK フラグが設定されていない限り無視されます。
lpTemplateNameLPWSTR8/4+52+32hInstance メンバーで識別されるモジュール内にある、ダイアログ ボックス テンプレート リソースの名前。このテンプレートは標準のダイアログ ボックス テンプレートの代わりに使用されます。番号付きのダイアログ ボックス リソースの場合、lpTemplateName には MAKEINTRESOURCE マクロが返す値を指定できます。このメンバーは、Flags メンバーに CC_ENABLETEMPLATE フラグが設定されていない限り無視されます。

公式ドキュメント

ChooseColor 関数が Color ダイアログ ボックスの初期化に使用する情報を格納します。ユーザーがダイアログ ボックスを閉じると、システムはユーザーの選択に関する情報をこの構造体に返します。

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

各言語での定義

#include <windows.h>

// CHOOSECOLORW  (x64 60 / x86 36 バイト)
#pragma pack(push, 1)
typedef struct CHOOSECOLORW {
    DWORD lStructSize;
    HWND hwndOwner;
    HWND hInstance;
    COLORREF rgbResult;
    COLORREF* lpCustColors;
    CHOOSECOLOR_FLAGS Flags;
    LPARAM lCustData;
    LPCCHOOKPROC lpfnHook;
    LPWSTR lpTemplateName;
} CHOOSECOLORW;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct CHOOSECOLORW
{
    public uint lStructSize;
    public IntPtr hwndOwner;
    public IntPtr hInstance;
    public uint rgbResult;
    public IntPtr lpCustColors;
    public uint Flags;
    public IntPtr lCustData;
    public IntPtr lpfnHook;
    public IntPtr lpTemplateName;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure CHOOSECOLORW
    Public lStructSize As UInteger
    Public hwndOwner As IntPtr
    Public hInstance As IntPtr
    Public rgbResult As UInteger
    Public lpCustColors As IntPtr
    Public Flags As UInteger
    Public lCustData As IntPtr
    Public lpfnHook As IntPtr
    Public lpTemplateName As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CHOOSECOLORW(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("lStructSize", wintypes.DWORD),
        ("hwndOwner", ctypes.c_void_p),
        ("hInstance", ctypes.c_void_p),
        ("rgbResult", wintypes.DWORD),
        ("lpCustColors", ctypes.c_void_p),
        ("Flags", wintypes.DWORD),
        ("lCustData", ctypes.c_ssize_t),
        ("lpfnHook", ctypes.c_void_p),
        ("lpTemplateName", ctypes.c_void_p),
    ]
#[repr(C, packed(1))]
pub struct CHOOSECOLORW {
    pub lStructSize: u32,
    pub hwndOwner: *mut core::ffi::c_void,
    pub hInstance: *mut core::ffi::c_void,
    pub rgbResult: u32,
    pub lpCustColors: *mut core::ffi::c_void,
    pub Flags: u32,
    pub lCustData: isize,
    pub lpfnHook: *mut core::ffi::c_void,
    pub lpTemplateName: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CHOOSECOLORW struct {
	lStructSize uint32
	hwndOwner uintptr
	hInstance uintptr
	rgbResult uint32
	lpCustColors uintptr
	Flags uint32
	lCustData uintptr
	lpfnHook uintptr
	lpTemplateName uintptr
}
type
  CHOOSECOLORW = packed record
    lStructSize: DWORD;
    hwndOwner: Pointer;
    hInstance: Pointer;
    rgbResult: DWORD;
    lpCustColors: Pointer;
    Flags: DWORD;
    lCustData: NativeInt;
    lpfnHook: Pointer;
    lpTemplateName: Pointer;
  end;
const CHOOSECOLORW = extern struct {
    lStructSize: u32,
    hwndOwner: ?*anyopaque,
    hInstance: ?*anyopaque,
    rgbResult: u32,
    lpCustColors: ?*anyopaque,
    Flags: u32,
    lCustData: isize,
    lpfnHook: ?*anyopaque,
    lpTemplateName: ?*anyopaque,
};
type
  CHOOSECOLORW {.packed.} = object
    lStructSize: uint32
    hwndOwner: pointer
    hInstance: pointer
    rgbResult: uint32
    lpCustColors: pointer
    Flags: uint32
    lCustData: int
    lpfnHook: pointer
    lpTemplateName: pointer
align(1)
struct CHOOSECOLORW
{
    uint lStructSize;
    void* hwndOwner;
    void* hInstance;
    uint rgbResult;
    void* lpCustColors;
    uint Flags;
    ptrdiff_t lCustData;
    void* lpfnHook;
    void* lpTemplateName;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CHOOSECOLORW サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; lStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hwndOwner : HWND (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hInstance : HWND (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; rgbResult : COLORREF (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpCustColors : COLORREF* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Flags : CHOOSECOLOR_FLAGS (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lCustData : LPARAM (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpfnHook : LPCCHOOKPROC (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lpTemplateName : LPWSTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CHOOSECOLORW サイズ: 60 バイト(x64)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; lStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hwndOwner : HWND (+4, 8byte)  qpoke st,4,値 / qpeek(st,4)  ※IronHSPのみ。3.7/3.8は lpoke st,4,下位 : lpoke st,8,上位
; hInstance : HWND (+12, 8byte)  qpoke st,12,値 / qpeek(st,12)  ※IronHSPのみ。3.7/3.8は lpoke st,12,下位 : lpoke st,16,上位
; rgbResult : COLORREF (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpCustColors : COLORREF* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; Flags : CHOOSECOLOR_FLAGS (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lCustData : LPARAM (+36, 8byte)  qpoke st,36,値 / qpeek(st,36)  ※IronHSPのみ。3.7/3.8は lpoke st,36,下位 : lpoke st,40,上位
; lpfnHook : LPCCHOOKPROC (+44, 8byte)  qpoke st,44,値 / qpeek(st,44)  ※IronHSPのみ。3.7/3.8は lpoke st,44,下位 : lpoke st,48,上位
; lpTemplateName : LPWSTR (+52, 8byte)  qpoke st,52,値 / qpeek(st,52)  ※IronHSPのみ。3.7/3.8は lpoke st,52,下位 : lpoke st,56,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CHOOSECOLORW, pack=1
    #field int lStructSize
    #field intptr hwndOwner
    #field intptr hInstance
    #field int rgbResult
    #field intptr lpCustColors
    #field int Flags
    #field intptr lCustData
    #field intptr lpfnHook
    #field intptr lpTemplateName
#endstruct

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