ホーム › UI.Controls.Dialogs › CHOOSECOLORA
CHOOSECOLORA
構造体サイズ=各フィールドのバイト数(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 | LPSTR | 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>
// CHOOSECOLORA (x64 60 / x86 36 バイト)
#pragma pack(push, 1)
typedef struct CHOOSECOLORA {
DWORD lStructSize;
HWND hwndOwner;
HWND hInstance;
COLORREF rgbResult;
COLORREF* lpCustColors;
CHOOSECOLOR_FLAGS Flags;
LPARAM lCustData;
LPCCHOOKPROC lpfnHook;
LPSTR lpTemplateName;
} CHOOSECOLORA;
#pragma pack(pop)using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct CHOOSECOLORA
{
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 CHOOSECOLORA
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 CHOOSECOLORA(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 CHOOSECOLORA {
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 CHOOSECOLORA struct {
lStructSize uint32
hwndOwner uintptr
hInstance uintptr
rgbResult uint32
lpCustColors uintptr
Flags uint32
lCustData uintptr
lpfnHook uintptr
lpTemplateName uintptr
}type
CHOOSECOLORA = packed record
lStructSize: DWORD;
hwndOwner: Pointer;
hInstance: Pointer;
rgbResult: DWORD;
lpCustColors: Pointer;
Flags: DWORD;
lCustData: NativeInt;
lpfnHook: Pointer;
lpTemplateName: Pointer;
end;const CHOOSECOLORA = extern struct {
lStructSize: u32,
hwndOwner: ?*anyopaque,
hInstance: ?*anyopaque,
rgbResult: u32,
lpCustColors: ?*anyopaque,
Flags: u32,
lCustData: isize,
lpfnHook: ?*anyopaque,
lpTemplateName: ?*anyopaque,
};type
CHOOSECOLORA {.packed.} = object
lStructSize: uint32
hwndOwner: pointer
hInstance: pointer
rgbResult: uint32
lpCustColors: pointer
Flags: uint32
lCustData: int
lpfnHook: pointer
lpTemplateName: pointeralign(1)
struct CHOOSECOLORA
{
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 レイアウト)
; CHOOSECOLORA サイズ: 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 : LPSTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CHOOSECOLORA サイズ: 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 : LPSTR (+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 CHOOSECOLORA, 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, CHOOSECOLORA ; NSTRUCT 変数を確保
st->lStructSize = 100
mes "lStructSize=" + st->lStructSize