PROPSHEETPAGEW_V2
構造体サイズ=各フィールドのバイト数(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) を使用する場合、このメンバーは無視されます。
- dwFlagsType: DWORD プロパティシートページを作成するときに使用するオプションを示すフラグです。このメンバーには、次の値の組み合わせを指定できます。
- dwSizeType: DWORD この構造体のサイズ (バイト単位) です。 - hActCtxType: HANDLE バージョン 6.0 以降。アクティブ化コンテキストのハンドルです。CreateActCtx でアクティブ化コンテキストを作成したときに返されるハンドルを、このメンバーに設定します。システムは、ダイアログボックスを作成する前にこのコンテキストをアクティブ化します。グローバルマニフェストを使用する場合、このメンバーを使用する必要はありません。「解説」を参照してください。 - 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_V2 (x64 88 / x86 48 バイト)
typedef struct PROPSHEETPAGEW_V2 {
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;
} PROPSHEETPAGEW_V2;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROPSHEETPAGEW_V2
{
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;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PROPSHEETPAGEW_V2
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
End Structureimport ctypes
from ctypes import wintypes
class PROPSHEETPAGEW_V2(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),
]#[repr(C)]
pub struct PROPSHEETPAGEW_V2 {
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,
}import "golang.org/x/sys/windows"
type PROPSHEETPAGEW_V2 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
}type
PROPSHEETPAGEW_V2 = 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;
end;const PROPSHEETPAGEW_V2 = 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,
};type
PROPSHEETPAGEW_V2 {.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: pointerstruct PROPSHEETPAGEW_V2
{
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;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PROPSHEETPAGEW_V2 サイズ: 48 バイト(x86)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 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 も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PROPSHEETPAGEW_V2 サイズ: 88 バイト(x64)
dim st, 22 ; 4byte整数×22(構造体サイズ 88 / 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,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PROPSHEETPAGEW_V2
#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
#endstruct
stdim st, PROPSHEETPAGEW_V2 ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。