PROPSHEETHEADERA_V2
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | この構造体のサイズをバイト単位で指定する。バージョンを示す。 |
| dwFlags | DWORD | 4 | +4 | +4 | プロパティシートの動作を制御するPSH_系フラグの組み合わせ。 |
| hwndParent | HWND | 8/4 | +8 | +8 | プロパティシートを所有する親ウィンドウのハンドル。 |
| hInstance | HINSTANCE | 8/4 | +16 | +12 | キャプションやアイコンを含むモジュールのインスタンスハンドル。 |
| Anonymous1 | _Anonymous1_e__Union | 8/4 | +24 | +16 | シートのアイコンを指定する共用体。アイコンハンドルまたはリソース識別子を保持する。 |
| pszCaption | LPSTR | 8/4 | +32 | +20 | プロパティシートのキャプション(タイトル)文字列。 |
| nPages | DWORD | 4 | +40 | +24 | シートに含まれるページの総数。 |
| Anonymous2 | _Anonymous2_e__Union | 8/4 | +48 | +28 | 初期表示ページのインデックスまたは開始ページ識別子を指定する共用体。 |
| Anonymous3 | _Anonymous3_e__Union | 8/4 | +56 | +32 | ページの配列を指定する共用体。PROPSHEETPAGEポインタまたはハンドル配列を保持する。 |
| pfnCallback | PFNPROPSHEETCALLBACK | 8/4 | +64 | +36 | シート作成/初期化時に呼ばれるコールバック関数へのポインタ。 |
| Anonymous4 | _Anonymous4_e__Union | 8/4 | +72 | +40 | ウィザードのウォーターマークビットマップを指定する共用体。 |
| hplWatermark | HPALETTE | 8/4 | +80 | +44 | バージョン 5.80 以降。ウォーターマークビットマップやヘッダービットマップの描画に使用する HPALETTE 構造体です。dwFlags メンバーに PSH_USEHPLWATERMARK が含まれていない場合、このメンバーは無視されます。 |
| Anonymous5 | _Anonymous5_e__Union | 8/4 | +88 | +48 | ウィザードのヘッダビットマップを指定する共用体。 |
共用体: _Anonymous1_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| hIcon | HICON | 8/4 | +0 | +0 |
| pszIcon | LPSTR | 8/4 | +0 | +0 |
共用体: _Anonymous2_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| nStartPage | DWORD | 4 | +0 | +0 |
| pStartPage | LPSTR | 8/4 | +0 | +0 |
共用体: _Anonymous3_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| ppsp | PROPSHEETPAGEA* | 8/4 | +0 | +0 |
| phpage | HPROPSHEETPAGE* | 8/4 | +0 | +0 |
共用体: _Anonymous4_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| hbmWatermark | HBITMAP | 8/4 | +0 | +0 | バージョン 5.80 以降。ウォーターマークビットマップのハンドルです。dwFlags メンバーに PSH_USEHBMWATERMARK が含まれていない場合、このメンバーは無視されます。 |
| pszbmWatermark | LPSTR | 8/4 | +0 | +0 | バージョン 5.80 以降。ウォーターマークとして使用するビットマップリソースです。このメンバーには、ビットマップリソースの識別子、またはビットマップリソースの名前を指定する文字列のアドレスのいずれかを指定できます。dwFlags メンバーに PSH_USEHBMWATERMARK が含まれている場合、このメンバーは無視されます。 |
共用体: _Anonymous5_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hbmHeader | HBITMAP | 8/4 | +0 | +0 | バージョン 5.80 以降。ヘッダービットマップのハンドルです。dwFlags メンバーに PSH_USEHBMHEADER が含まれていない場合、このメンバーは無視されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pszbmHeader | LPSTR | 8/4 | +0 | +0 | バージョン 5.80 以降。ヘッダーとして使用するビットマップリソースです。このメンバーには、ビットマップリソースの識別子、またはビットマップリソースの名前を指定する文字列のアドレスのいずれかを指定できます。dwFlags メンバーに PSH_USEHBMHEADER が含まれている場合、このメンバーは無視されます。 - dwFlagsType: DWORD プロパティシートページを作成するときに使用するオプションを示すフラグです。このメンバーには、次の値の組み合わせを指定できます。
- dwSizeType: DWORD この構造体のサイズ (バイト単位)。プロパティシートマネージャーは、このメンバーによって、使用している PROPSHEETHEADER 構造体のバージョンを判断します。詳細については、「解説」を参照してください。 - hIconType: HICON プロパティシートダイアログボックスのタイトルバーで小さいアイコンとして使用するアイコンのハンドルです。dwFlags メンバーに PSH_USEHICON が含まれていない場合、このメンバーは無視されます。このメンバーは pszIcon との共用体として宣言されています。 - hInstanceType: HINSTANCE アイコンまたはタイトル文字列のリソースを読み込む元となるインスタンスのハンドルです。pszIcon または pszCaption メンバーが読み込むリソースを示している場合、このメンバーを指定しなければなりません。 - hwndParentType: HWND プロパティシートのオーナーウィンドウのハンドルです。 - nPagesType: UINT phpage 配列の要素数です。 - nStartPageType: UINT プロパティシートダイアログボックスの作成時に最初に表示されるページの、0 から始まるインデックスです。このメンバーは pStartPage との共用体として宣言されています。 - pStartPageType: LPCTSTR プロパティシートダイアログボックスの作成時に最初に表示されるページの名前です。このメンバーには、文字列リソースの識別子、または名前を指定する文字列のアドレスのいずれかを指定できます。このメンバーは nStartPage との共用体として宣言されています。 - pfnCallbackType: PFNPROPSHEETCALLBACK プロパティシートの初期化時に呼び出される、アプリケーション定義のコールバック関数へのポインターです。コールバック関数の詳細については、PropSheetProc 関数の説明を参照してください。 dwFlags メンバーに PSH_USECALLBACK が含まれていない場合、このメンバーは無視されます。 - phpageType: HPROPSHEETPAGE* プロパティシートページのハンドルの配列へのポインターです。各ハンドルは、事前に CreatePropertySheetPage 関数を呼び出して作成されたものでなければなりません。dwFlags メンバーに PSH_PROPSHEETPAGE が含まれている場合、phpage は無視されるため、NULL に設定してください。PropertySheet 関数から戻った時点で、phpage 配列内の HPROPSHEETPAGE ハンドルはすべて破棄されています。このメンバーは ppsp との共用体として宣言されています。 - ppspType: LPCPROPSHEETPAGE プロパティシート内のページを定義する PROPSHEETPAGE 構造体の配列へのポインターです。dwFlags メンバーに PSH_PROPSHEETPAGE が含まれていない場合、このメンバーは無視されます。PROPSHEETPAGE 構造体はサイズが可変であることに注意してください。ppsp が指す配列を解析するアプリケーションは、各ページのサイズを考慮しなければなりません。このメンバーは phpage との共用体として宣言されています。 - pszCaptionType: LPCTSTR プロパティシートダイアログボックスのタイトルです。このメンバーには、文字列リソースの識別子、またはタイトルを指定する文字列のアドレスのいずれかを指定できます。dwFlags メンバーに PSH_PROPTITLE が含まれている場合、タイトルの先頭に "Properties for" という文字列が挿入されます。このフィールドは Wizard97 ウィザードでは無視されます。Aero ウィザードでは、PSH_PROPTITLE フラグが設定されているかどうかに関係なく、文字列のみがキャプションとして使用されます。 - pszIconType: LPCTSTR プロパティシートダイアログボックスのタイトルバーで小さいアイコンとして使用するアイコンリソースです。このメンバーには、アイコンリソースの識別子、またはアイコンリソースの名前を指定する文字列のアドレスのいずれかを指定できます。dwFlags メンバーに PSH_USEICONID が含まれていない場合、このメンバーは無視されます。このメンバーは hIcon との共用体として宣言されています。 |
公式ドキュメント
プロパティシートのフレームとページを定義します。
この構造体はコード内で直接使用することを意図していません。代わりに PROPSHEETHEADER 構造体を使用してください。
解説(Remarks)
ユーザーが Large Fonts のようにダイアログボックスを拡大する設定を選択した場合、開始ページと終了ページに描画されるウォーターマークも拡大されます。元のビットマップのサイズと位置は変わりません。追加された領域は、ビットマップの左上隅のピクセルの色で塗りつぶされます。
この構造体のいくつかのメンバーは、Comctl32.dll のバージョン 4.71 以降でのみサポートされることに注意してください。これらのメンバーを有効にするには、ヘッダーに次のいずれかを記述します。
#define _WIN32_IE 0x0400 // For version 4.71
または
#define _WIN32_IE 0x0500 // For version 5.80
ただし、構造体はそのサイズで初期化しなければなりません。現在定義されている構造体のサイズを使用すると、より小さい構造体を想定している以前のバージョンの Comctl32.dll ではアプリケーションが動作しない可能性があります。これには、Internet Explorer 4.0 以降がインストールされていない Windows 95 または Microsoft Windows NT 4.0 のすべてのシステムが含まれます。適切な バージョン番号 を定義すれば、4.71 より前のバージョンの Comctl32.dll でアプリケーションを実行できます。ただし、アプリケーションをより新しいバージョンのシステムでも実行する必要がある場合は、問題が生じる可能性があります。
最新のヘッダーファイルを使用し、PROPSHEETHEADER 構造体のサイズを適切に設定すれば、すべてのバージョンの Comctl32.dll との互換性を保てます。構造体を初期化する前に、DllGetVersion 関数を使用して、システムにインストールされている Comctl32.dll のバージョンを確認してください。バージョン 4.71 以降の場合は、
psh.dwSize = sizeof(PROPSHEETHEADER);
を使用して dwSize メンバーを初期化します。それより前のバージョンでは、4.71 より前の構造体のサイズは PROPSHEETHEADER_V1_SIZE 定数で与えられます。次のように記述してください。
psh.dwSize = PROPSHEETHEADER_V1_SIZE;
PSH_WIZARD、PSH_WIZARD97、PSH_WIZARD_LITE の各スタイルは相互に互換性がありません。これらのスタイルフラグは 1 つだけ設定してください。PSH_AEROWIZARD は PSH_WIZARD と組み合わせなければなりません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PROPSHEETHEADERA_V2 (x64 96 / x86 52 バイト)
typedef struct PROPSHEETHEADERA_V2 {
DWORD dwSize;
DWORD dwFlags;
HWND hwndParent;
HINSTANCE hInstance;
_Anonymous1_e__Union Anonymous1;
LPSTR pszCaption;
DWORD nPages;
_Anonymous2_e__Union Anonymous2;
_Anonymous3_e__Union Anonymous3;
PFNPROPSHEETCALLBACK pfnCallback;
_Anonymous4_e__Union Anonymous4;
HPALETTE hplWatermark;
_Anonymous5_e__Union Anonymous5;
} PROPSHEETHEADERA_V2;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROPSHEETHEADERA_V2
{
public uint dwSize;
public uint dwFlags;
public IntPtr hwndParent;
public IntPtr hInstance;
public _Anonymous1_e__Union Anonymous1;
public IntPtr pszCaption;
public uint nPages;
public _Anonymous2_e__Union Anonymous2;
public _Anonymous3_e__Union Anonymous3;
public IntPtr pfnCallback;
public _Anonymous4_e__Union Anonymous4;
public IntPtr hplWatermark;
public _Anonymous5_e__Union Anonymous5;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PROPSHEETHEADERA_V2
Public dwSize As UInteger
Public dwFlags As UInteger
Public hwndParent As IntPtr
Public hInstance As IntPtr
Public Anonymous1 As _Anonymous1_e__Union
Public pszCaption As IntPtr
Public nPages As UInteger
Public Anonymous2 As _Anonymous2_e__Union
Public Anonymous3 As _Anonymous3_e__Union
Public pfnCallback As IntPtr
Public Anonymous4 As _Anonymous4_e__Union
Public hplWatermark As IntPtr
Public Anonymous5 As _Anonymous5_e__Union
End Structureimport ctypes
from ctypes import wintypes
class PROPSHEETHEADERA_V2(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("hwndParent", ctypes.c_void_p),
("hInstance", ctypes.c_void_p),
("Anonymous1", _Anonymous1_e__Union),
("pszCaption", ctypes.c_void_p),
("nPages", wintypes.DWORD),
("Anonymous2", _Anonymous2_e__Union),
("Anonymous3", _Anonymous3_e__Union),
("pfnCallback", ctypes.c_void_p),
("Anonymous4", _Anonymous4_e__Union),
("hplWatermark", ctypes.c_void_p),
("Anonymous5", _Anonymous5_e__Union),
]#[repr(C)]
pub struct PROPSHEETHEADERA_V2 {
pub dwSize: u32,
pub dwFlags: u32,
pub hwndParent: *mut core::ffi::c_void,
pub hInstance: *mut core::ffi::c_void,
pub Anonymous1: _Anonymous1_e__Union,
pub pszCaption: *mut core::ffi::c_void,
pub nPages: u32,
pub Anonymous2: _Anonymous2_e__Union,
pub Anonymous3: _Anonymous3_e__Union,
pub pfnCallback: *mut core::ffi::c_void,
pub Anonymous4: _Anonymous4_e__Union,
pub hplWatermark: *mut core::ffi::c_void,
pub Anonymous5: _Anonymous5_e__Union,
}import "golang.org/x/sys/windows"
type PROPSHEETHEADERA_V2 struct {
dwSize uint32
dwFlags uint32
hwndParent uintptr
hInstance uintptr
Anonymous1 _Anonymous1_e__Union
pszCaption uintptr
nPages uint32
Anonymous2 _Anonymous2_e__Union
Anonymous3 _Anonymous3_e__Union
pfnCallback uintptr
Anonymous4 _Anonymous4_e__Union
hplWatermark uintptr
Anonymous5 _Anonymous5_e__Union
}type
PROPSHEETHEADERA_V2 = record
dwSize: DWORD;
dwFlags: DWORD;
hwndParent: Pointer;
hInstance: Pointer;
Anonymous1: _Anonymous1_e__Union;
pszCaption: Pointer;
nPages: DWORD;
Anonymous2: _Anonymous2_e__Union;
Anonymous3: _Anonymous3_e__Union;
pfnCallback: Pointer;
Anonymous4: _Anonymous4_e__Union;
hplWatermark: Pointer;
Anonymous5: _Anonymous5_e__Union;
end;const PROPSHEETHEADERA_V2 = extern struct {
dwSize: u32,
dwFlags: u32,
hwndParent: ?*anyopaque,
hInstance: ?*anyopaque,
Anonymous1: _Anonymous1_e__Union,
pszCaption: ?*anyopaque,
nPages: u32,
Anonymous2: _Anonymous2_e__Union,
Anonymous3: _Anonymous3_e__Union,
pfnCallback: ?*anyopaque,
Anonymous4: _Anonymous4_e__Union,
hplWatermark: ?*anyopaque,
Anonymous5: _Anonymous5_e__Union,
};type
PROPSHEETHEADERA_V2 {.bycopy.} = object
dwSize: uint32
dwFlags: uint32
hwndParent: pointer
hInstance: pointer
Anonymous1: _Anonymous1_e__Union
pszCaption: pointer
nPages: uint32
Anonymous2: _Anonymous2_e__Union
Anonymous3: _Anonymous3_e__Union
pfnCallback: pointer
Anonymous4: _Anonymous4_e__Union
hplWatermark: pointer
Anonymous5: _Anonymous5_e__Unionstruct PROPSHEETHEADERA_V2
{
uint dwSize;
uint dwFlags;
void* hwndParent;
void* hInstance;
_Anonymous1_e__Union Anonymous1;
void* pszCaption;
uint nPages;
_Anonymous2_e__Union Anonymous2;
_Anonymous3_e__Union Anonymous3;
void* pfnCallback;
_Anonymous4_e__Union Anonymous4;
void* hplWatermark;
_Anonymous5_e__Union Anonymous5;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PROPSHEETHEADERA_V2 サイズ: 52 バイト(x86)
dim st, 13 ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hwndParent : HWND (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; hInstance : HINSTANCE (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Anonymous1 : _Anonymous1_e__Union (+16, 4byte) varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; pszCaption : LPSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; nPages : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; Anonymous2 : _Anonymous2_e__Union (+28, 4byte) varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; Anonymous3 : _Anonymous3_e__Union (+32, 4byte) varptr(st)+32 を基点に操作(4byte:入れ子/配列)
; pfnCallback : PFNPROPSHEETCALLBACK (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; Anonymous4 : _Anonymous4_e__Union (+40, 4byte) varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; hplWatermark : HPALETTE (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; Anonymous5 : _Anonymous5_e__Union (+48, 4byte) varptr(st)+48 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PROPSHEETHEADERA_V2 サイズ: 96 バイト(x64)
dim st, 24 ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hwndParent : HWND (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; hInstance : HINSTANCE (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; Anonymous1 : _Anonymous1_e__Union (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; pszCaption : LPSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; nPages : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; Anonymous2 : _Anonymous2_e__Union (+48, 8byte) varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; Anonymous3 : _Anonymous3_e__Union (+56, 8byte) varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; pfnCallback : PFNPROPSHEETCALLBACK (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; Anonymous4 : _Anonymous4_e__Union (+72, 8byte) varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; hplWatermark : HPALETTE (+80, 8byte) qpoke st,80,値 / qpeek(st,80) ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; Anonymous5 : _Anonymous5_e__Union (+88, 8byte) varptr(st)+88 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PROPSHEETHEADERA_V2
#field int dwSize
#field int dwFlags
#field intptr hwndParent
#field intptr hInstance
#field byte Anonymous1 8
#field intptr pszCaption
#field int nPages
#field byte Anonymous2 8
#field byte Anonymous3 8
#field intptr pfnCallback
#field byte Anonymous4 8
#field intptr hplWatermark
#field byte Anonymous5 8
#endstruct
stdim st, PROPSHEETHEADERA_V2 ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。