PROPSHEETPAGEW_V3
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | この構造体のサイズをバイト単位で指定する。バージョンを示す。 | ||||||||||||||||||||||||||||||
| dwFlags | DWORD | 4 | +4 | +4 | ページの動作を制御するPSP_系フラグの組み合わせ。 | ||||||||||||||||||||||||||||||
| hInstance | HINSTANCE | 8/4 | +8 | +8 | ダイアログテンプレートやアイコンを含むモジュールのハンドル。 | ||||||||||||||||||||||||||||||
| Anonymous1 | _Anonymous1_e__Union | 8/4 | +16 | +12 | ダイアログテンプレートを指定する共用体。リソース名またはメモリ内テンプレートを保持する。 | ||||||||||||||||||||||||||||||
| Anonymous2 | _Anonymous2_e__Union | 8/4 | +24 | +16 | ページのアイコンを指定する共用体。アイコンハンドルまたはリソース識別子を保持する。 | ||||||||||||||||||||||||||||||
| pszTitle | LPWSTR | 8/4 | +32 | +20 | PSP_USETITLE指定時にタブに表示するページのタイトル文字列。 | ||||||||||||||||||||||||||||||
| pfnDlgProc | DLGPROC | 8/4 | +40 | +24 | ページのダイアログプロシージャへのポインタ。 | ||||||||||||||||||||||||||||||
| lParam | LPARAM | 8/4 | +48 | +28 | アプリケーション定義データ。ダイアログプロシージャに渡される。 | ||||||||||||||||||||||||||||||
| pfnCallback | LPFNPSPCALLBACKW | 8/4 | +56 | +32 | ページの作成/破棄時に呼ばれるコールバック関数へのポインタ。 | ||||||||||||||||||||||||||||||
| pcRefParent | DWORD* | 8/4 | +64 | +36 | 親のプロパティシートの参照カウントへのポインタ。PSP_USEREFPARENT時に使う。 | ||||||||||||||||||||||||||||||
| pszHeaderTitle | LPWSTR | 8/4 | +72 | +40 | バージョン 5.80 以降。ヘッダー領域のタイトルです。Wizard97 スタイルのウィザードでこのメンバーを使用するには、次の作業も必要です。
| ||||||||||||||||||||||||||||||
| pszHeaderSubTitle | LPWSTR | 8/4 | +80 | +44 | バージョン 5.80。ヘッダー領域のサブタイトルです。このメンバーを使用するには、次の作業が必要です。
メモ このメンバーは、Aero スタイルのウィザード (PSH_AEROWIZARD) を使用する場合は無視されます。
| ||||||||||||||||||||||||||||||
| hActCtx | HANDLE | 8/4 | +88 | +48 | バージョン 6.0 以降。アクティベーションコンテキストのハンドルです。CreateActCtx でアクティベーションコンテキストを作成したときに返されるハンドルを、このメンバーに設定します。システムは、ダイアログボックスを作成する前にこのコンテキストをアクティブ化します。グローバルマニフェストを使用する場合、このメンバーを使用する必要はありません。「解説」を参照してください。 - dwFlagsType: DWORD プロパティシートページを作成する際に使用するオプションを示すフラグです。このメンバーには、次の値の組み合わせを指定できます。
- dwSizeType: DWORD この構造体のサイズ (バイト単位)。 - hIconType: HICON ページのタブにアイコンとして使用するアイコンのハンドルです。dwFlags メンバーに PSP_USEHICON が含まれていない場合、このメンバーは無視されます。このメンバーは pszIcon との共用体として宣言されています。 - hInstanceType: HINSTANCE アイコンまたは文字列リソースの読み込み元となるインスタンスのハンドルです。pszIcon、pszTitle、pszHeaderTitle、pszHeaderSubTitle のいずれかのメンバーが読み込むリソースを指定している場合は、hInstance を指定しなければなりません。 - lParamType: LPARAM ページが作成されるとき、そのページの PROPSHEETPAGE 構造体のコピーが WM_INITDIALOG メッセージとともにダイアログボックスプロシージャーに渡されます。lParam メンバーは、アプリケーション固有の情報をダイアログボックスプロシージャーに渡すために用意されています。ページ自体には影響しません。詳細については、プロパティシートの作成を参照してください。 - pResourceType: LPCDLGTEMPLATE メモリ内のダイアログボックステンプレートへのポインターです。PropertySheet 関数は、テンプレートが書き込み保護されていないことを前提とします。読み取り専用のテンプレートは、一部のバージョンの Windows で例外を発生させます。このメンバーを使用するには、dwFlags メンバーに PSP_DLGINDIRECT フラグを設定しなければなりません。このメンバーは pszTemplate との共用体として宣言されています。 - pcRefParentType: UINT* 参照カウント値へのポインターです。このメンバーを使用するには、dwFlags メンバーに PSP_USEREFPARENT フラグを設定しなければなりません。 メモ プロパティシートページが作成されると、pcRefParent が指す値がインクリメントされます。プロパティシートページは、PROPSHEETHEADER の dwFlags メンバーに PSH_PROPSHEETPAGE フラグを設定して PropertySheet 関数を呼び出すことで、暗黙的に作成されます。CreatePropertySheetPage 関数を使用して明示的に作成することもできます。プロパティシートページが破棄されると、pcRefParent メンバーが指す値がデクリメントされます。これは、プロパティシートが破棄されるときに自動的に行われます。DestroyPropertySheetPage 関数を使用して、プロパティシートページを明示的に破棄することもできます。
- pfnCallbackType: LPFNPSPCALLBACK ページの作成時と破棄される直前に呼び出される、アプリケーション定義のコールバック関数へのポインターです。コールバック関数の詳細については、PropSheetPageProc を参照してください。このメンバーを使用するには、dwFlags メンバーに PSP_USECALLBACK フラグを設定しなければなりません。 - pfnDlgProcType: DLGPROC ページのダイアログボックスプロシージャーへのポインターです。ページはモードレスダイアログボックスとして作成されるため、ダイアログボックスプロシージャーは EndDialog 関数を呼び出してはなりません。 - pszIconType: LPCSTR ページのタブにアイコンとして使用するアイコンリソースです。このメンバーには、アイコンリソースの識別子、またはアイコンリソースの名前を指定する文字列のアドレスのいずれかを指定できます。このメンバーを使用するには、dwFlags メンバーに PSP_USEICONID フラグを設定しなければなりません。このメンバーは hIcon との共用体として宣言されています。 - pszTemplateType: LPCSTR ページの作成に使用するダイアログボックステンプレートです。このメンバーには、テンプレートのリソース識別子、またはテンプレートの名前を指定する文字列のアドレスのいずれかを指定できます。dwFlags メンバーに PSP_DLGINDIRECT フラグが設定されている場合、pszTemplate は無視されます。このメンバーは pResource との共用体として宣言されています。 - pszTitleType: LPCSTR プロパティシートダイアログボックスのタイトルです。このタイトルは、ダイアログボックステンプレートで指定されたタイトルより優先されます。このメンバーには、文字列リソースの識別子、またはタイトルを指定する文字列のアドレスのいずれかを指定できます。このメンバーを使用するには、dwFlags メンバーに PSP_USETITLE フラグを設定しなければなりません。 |
共用体: _Anonymous1_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| pszTemplate | LPWSTR | 8/4 | +0 | +0 |
| pResource | DLGTEMPLATE* | 8/4 | +0 | +0 |
共用体: _Anonymous2_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 |
|---|---|---|---|---|
| hIcon | HICON | 8/4 | +0 | +0 |
| pszIcon | LPWSTR | 8/4 | +0 | +0 |
公式ドキュメント
プロパティシート内のページを定義します。
この構造体は、コード内で直接使用することを意図したものではありません。代わりに PROPSHEETPAGE 構造体を使用してください。
解説(Remarks)
Comctl32.dll のバージョン 6 以降は再頒布できません。Comctl32.dll のバージョン 6 以降を使用するには、マニフェストでその .dll ファイルを指定します。マニフェストの詳細については、ビジュアルスタイルの有効化を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PROPSHEETPAGEW_V3 (x64 96 / x86 52 バイト)
typedef struct PROPSHEETPAGEW_V3 {
DWORD dwSize;
DWORD dwFlags;
HINSTANCE hInstance;
_Anonymous1_e__Union Anonymous1;
_Anonymous2_e__Union Anonymous2;
LPWSTR pszTitle;
DLGPROC pfnDlgProc;
LPARAM lParam;
LPFNPSPCALLBACKW pfnCallback;
DWORD* pcRefParent;
LPWSTR pszHeaderTitle;
LPWSTR pszHeaderSubTitle;
HANDLE hActCtx;
} PROPSHEETPAGEW_V3;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROPSHEETPAGEW_V3
{
public uint dwSize;
public uint dwFlags;
public IntPtr hInstance;
public _Anonymous1_e__Union Anonymous1;
public _Anonymous2_e__Union Anonymous2;
public IntPtr pszTitle;
public IntPtr pfnDlgProc;
public IntPtr lParam;
public IntPtr pfnCallback;
public IntPtr pcRefParent;
public IntPtr pszHeaderTitle;
public IntPtr pszHeaderSubTitle;
public IntPtr hActCtx;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PROPSHEETPAGEW_V3
Public dwSize As UInteger
Public dwFlags As UInteger
Public hInstance As IntPtr
Public Anonymous1 As _Anonymous1_e__Union
Public Anonymous2 As _Anonymous2_e__Union
Public pszTitle As IntPtr
Public pfnDlgProc As IntPtr
Public lParam As IntPtr
Public pfnCallback As IntPtr
Public pcRefParent As IntPtr
Public pszHeaderTitle As IntPtr
Public pszHeaderSubTitle As IntPtr
Public hActCtx As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class PROPSHEETPAGEW_V3(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("hInstance", ctypes.c_void_p),
("Anonymous1", _Anonymous1_e__Union),
("Anonymous2", _Anonymous2_e__Union),
("pszTitle", ctypes.c_void_p),
("pfnDlgProc", ctypes.c_void_p),
("lParam", ctypes.c_ssize_t),
("pfnCallback", ctypes.c_void_p),
("pcRefParent", ctypes.c_void_p),
("pszHeaderTitle", ctypes.c_void_p),
("pszHeaderSubTitle", ctypes.c_void_p),
("hActCtx", ctypes.c_void_p),
]#[repr(C)]
pub struct PROPSHEETPAGEW_V3 {
pub dwSize: u32,
pub dwFlags: u32,
pub hInstance: *mut core::ffi::c_void,
pub Anonymous1: _Anonymous1_e__Union,
pub Anonymous2: _Anonymous2_e__Union,
pub pszTitle: *mut core::ffi::c_void,
pub pfnDlgProc: *mut core::ffi::c_void,
pub lParam: isize,
pub pfnCallback: *mut core::ffi::c_void,
pub pcRefParent: *mut core::ffi::c_void,
pub pszHeaderTitle: *mut core::ffi::c_void,
pub pszHeaderSubTitle: *mut core::ffi::c_void,
pub hActCtx: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type PROPSHEETPAGEW_V3 struct {
dwSize uint32
dwFlags uint32
hInstance uintptr
Anonymous1 _Anonymous1_e__Union
Anonymous2 _Anonymous2_e__Union
pszTitle uintptr
pfnDlgProc uintptr
lParam uintptr
pfnCallback uintptr
pcRefParent uintptr
pszHeaderTitle uintptr
pszHeaderSubTitle uintptr
hActCtx uintptr
}type
PROPSHEETPAGEW_V3 = record
dwSize: DWORD;
dwFlags: DWORD;
hInstance: Pointer;
Anonymous1: _Anonymous1_e__Union;
Anonymous2: _Anonymous2_e__Union;
pszTitle: Pointer;
pfnDlgProc: Pointer;
lParam: NativeInt;
pfnCallback: Pointer;
pcRefParent: Pointer;
pszHeaderTitle: Pointer;
pszHeaderSubTitle: Pointer;
hActCtx: Pointer;
end;const PROPSHEETPAGEW_V3 = extern struct {
dwSize: u32,
dwFlags: u32,
hInstance: ?*anyopaque,
Anonymous1: _Anonymous1_e__Union,
Anonymous2: _Anonymous2_e__Union,
pszTitle: ?*anyopaque,
pfnDlgProc: ?*anyopaque,
lParam: isize,
pfnCallback: ?*anyopaque,
pcRefParent: ?*anyopaque,
pszHeaderTitle: ?*anyopaque,
pszHeaderSubTitle: ?*anyopaque,
hActCtx: ?*anyopaque,
};type
PROPSHEETPAGEW_V3 {.bycopy.} = object
dwSize: uint32
dwFlags: uint32
hInstance: pointer
Anonymous1: _Anonymous1_e__Union
Anonymous2: _Anonymous2_e__Union
pszTitle: pointer
pfnDlgProc: pointer
lParam: int
pfnCallback: pointer
pcRefParent: pointer
pszHeaderTitle: pointer
pszHeaderSubTitle: pointer
hActCtx: pointerstruct PROPSHEETPAGEW_V3
{
uint dwSize;
uint dwFlags;
void* hInstance;
_Anonymous1_e__Union Anonymous1;
_Anonymous2_e__Union Anonymous2;
void* pszTitle;
void* pfnDlgProc;
ptrdiff_t lParam;
void* pfnCallback;
void* pcRefParent;
void* pszHeaderTitle;
void* pszHeaderSubTitle;
void* hActCtx;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PROPSHEETPAGEW_V3 サイズ: 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 も可)
; hInstance : HINSTANCE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; Anonymous1 : _Anonymous1_e__Union (+12, 4byte) varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; Anonymous2 : _Anonymous2_e__Union (+16, 4byte) varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; pszTitle : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pfnDlgProc : DLGPROC (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; lParam : LPARAM (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; pfnCallback : LPFNPSPCALLBACKW (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pcRefParent : DWORD* (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; pszHeaderTitle : LPWSTR (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; pszHeaderSubTitle : LPWSTR (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; hActCtx : HANDLE (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PROPSHEETPAGEW_V3 サイズ: 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 も可)
; hInstance : HINSTANCE (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; Anonymous1 : _Anonymous1_e__Union (+16, 8byte) varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; Anonymous2 : _Anonymous2_e__Union (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; pszTitle : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pfnDlgProc : DLGPROC (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lParam : LPARAM (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pfnCallback : LPFNPSPCALLBACKW (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pcRefParent : DWORD* (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; pszHeaderTitle : LPWSTR (+72, 8byte) qpoke st,72,値 / qpeek(st,72) ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; pszHeaderSubTitle : LPWSTR (+80, 8byte) qpoke st,80,値 / qpeek(st,80) ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; hActCtx : HANDLE (+88, 8byte) qpoke st,88,値 / qpeek(st,88) ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PROPSHEETPAGEW_V3
#field int dwSize
#field int dwFlags
#field intptr hInstance
#field byte Anonymous1 8
#field byte Anonymous2 8
#field intptr pszTitle
#field intptr pfnDlgProc
#field intptr lParam
#field intptr pfnCallback
#field intptr pcRefParent
#field intptr pszHeaderTitle
#field intptr pszHeaderSubTitle
#field intptr hActCtx
#endstruct
stdim st, PROPSHEETPAGEW_V3 ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。