PROPSHEETHEADERW_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 | LPWSTR | 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 | Version 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 | LPWSTR | 8/4 | +0 | +0 |
共用体: _Anonymous2_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| nStartPage | DWORD | 4 | +0 | +0 |
| pStartPage | LPWSTR | 8/4 | +0 | +0 |
共用体: _Anonymous3_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| ppsp | PROPSHEETPAGEW* | 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 | Version 5.80 以降。ウォーターマーク ビットマップのハンドルです。dwFlags メンバーに PSH_USEHBMWATERMARK が含まれていない場合、このメンバーは無視されます。 |
| pszbmWatermark | LPWSTR | 8/4 | +0 | +0 | Version 5.80 以降。ウォーターマークとして使用するビットマップ リソースです。このメンバーには、ビットマップ リソースの識別子、またはビットマップ リソース名を指定する文字列のアドレスのいずれかを指定できます。dwFlags メンバーに PSH_USEHBMWATERMARK が含まれている場合、このメンバーは無視されます。 |
共用体: _Anonymous5_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hbmHeader | HBITMAP | 8/4 | +0 | +0 | Version 5.80 以降。ヘッダー ビットマップのハンドルです。dwFlags メンバーに PSH_USEHBMHEADER が含まれていない場合、このメンバーは無視されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pszbmHeader | LPWSTR | 8/4 | +0 | +0 | Version 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)
ユーザーが大きいフォントなど、ダイアログ ボックスを拡大する設定を選択した場合、開始ページと終了ページに描画されるウォーターマークも拡大されます。元のビットマップのサイズと位置は変わりません。追加された領域は、ビットマップの左上隅のピクセルの色で塗りつぶされます。
この構造体のいくつかのメンバーは、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>
// PROPSHEETHEADERW_V2 (x64 96 / x86 52 バイト)
typedef struct PROPSHEETHEADERW_V2 {
DWORD dwSize;
DWORD dwFlags;
HWND hwndParent;
HINSTANCE hInstance;
_Anonymous1_e__Union Anonymous1;
LPWSTR pszCaption;
DWORD nPages;
_Anonymous2_e__Union Anonymous2;
_Anonymous3_e__Union Anonymous3;
PFNPROPSHEETCALLBACK pfnCallback;
_Anonymous4_e__Union Anonymous4;
HPALETTE hplWatermark;
_Anonymous5_e__Union Anonymous5;
} PROPSHEETHEADERW_V2;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROPSHEETHEADERW_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 PROPSHEETHEADERW_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 PROPSHEETHEADERW_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 PROPSHEETHEADERW_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 PROPSHEETHEADERW_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
PROPSHEETHEADERW_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 PROPSHEETHEADERW_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
PROPSHEETHEADERW_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 PROPSHEETHEADERW_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 レイアウト)
; PROPSHEETHEADERW_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 : LPWSTR (+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 レイアウト)
; PROPSHEETHEADERW_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 : LPWSTR (+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 PROPSHEETHEADERW_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, PROPSHEETHEADERW_V2 ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。