ホーム › UI.Controls.Dialogs › CHOOSECOLORW
CHOOSECOLORW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| lStructSize | DWORD | 4 | +0 | +0 | 構造体の長さ (バイト単位)。 | ||||||||||||||||||||
| hwndOwner | HWND | 8/4 | +4 | +4 | ダイアログ ボックスを所有するウィンドウへのハンドル。このメンバーには任意の有効なウィンドウ ハンドルを指定できます。また、ダイアログ ボックスに所有者がない場合は NULL を指定できます。 | ||||||||||||||||||||
| hInstance | HWND | 8/4 | +12 | +8 | Flags メンバーに CC_ENABLETEMPLATEHANDLE フラグが設定されている場合、hInstance はダイアログ ボックス テンプレートを含むメモリ オブジェクトへのハンドルです。CC_ENABLETEMPLATE フラグが設定されている場合、hInstance は lpTemplateName メンバーで指定された名前のダイアログ ボックス テンプレートを含むモジュールへのハンドルです。CC_ENABLETEMPLATEHANDLE と CC_ENABLETEMPLATE のどちらも設定されていない場合、このメンバーは無視されます。 | ||||||||||||||||||||
| rgbResult | COLORREF | 4 | +20 | +12 | CC_RGBINIT フラグが設定されている場合、rgbResult はダイアログ ボックスの作成時に最初に選択される色を指定します。指定した色の値が利用可能な色に含まれていない場合、システムは利用可能な最も近い純色を選択します。rgbResult が 0 の場合、または CC_RGBINIT が設定されていない場合、最初に選択される色は黒になります。ユーザーが OK ボタンをクリックすると、rgbResult にはユーザーが選択した色が格納されます。COLORREF の色の値を作成するには、RGB マクロを使用します。 | ||||||||||||||||||||
| lpCustColors | COLORREF* | 8/4 | +24 | +16 | ダイアログ ボックスのカスタム カラー ボックスに使用する赤、緑、青 (RGB) の値を格納する、16 個の値の配列へのポインター。ユーザーがこれらの色を変更すると、システムは新しい RGB 値で配列を更新します。ChooseColor 関数の呼び出し間で新しいカスタム カラーを保持するには、この配列に静的メモリを割り当てる必要があります。COLORREF の色の値を作成するには、RGB マクロを使用します。 | ||||||||||||||||||||
| Flags | CHOOSECOLOR_FLAGS | 4 | +32 | +20 | Color ダイアログ ボックスの初期化に使用できるビット フラグのセット。ダイアログ ボックスから制御が戻るとき、ユーザーの入力を示すためにこれらのフラグが設定されます。このメンバーには、次のフラグの組み合わせを指定できます。
| ||||||||||||||||||||
| lCustData | LPARAM | 8/4 | +36 | +24 | lpfnHook メンバーで識別されるフック プロシージャにシステムが渡す、アプリケーション定義のデータ。システムがフック プロシージャに WM_INITDIALOG メッセージを送信するとき、メッセージの lParam パラメーターは、ダイアログ ボックスの作成時に指定された CHOOSECOLOR 構造体へのポインターです。フック プロシージャはこのポインターを使用して lCustData の値を取得できます。 | ||||||||||||||||||||
| lpfnHook | LPCCHOOKPROC | 8/4 | +44 | +28 | ダイアログ ボックス宛てのメッセージを処理できる CCHookProc フック プロシージャへのポインター。このメンバーは、Flags メンバーに CC_ENABLEHOOK フラグが設定されていない限り無視されます。 | ||||||||||||||||||||
| lpTemplateName | LPWSTR | 8/4 | +52 | +32 | hInstance メンバーで識別されるモジュール内にある、ダイアログ ボックス テンプレート リソースの名前。このテンプレートは標準のダイアログ ボックス テンプレートの代わりに使用されます。番号付きのダイアログ ボックス リソースの場合、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)
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 Structureimport 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: pointeralign(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