PROPSHEETPAGEA_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 | LPSTR | 8/4 | +32 | +20 | PSP_USETITLE指定時にタブに表示するページのタイトル文字列。 | ||||||||||||||||||||||||||||||
| pfnDlgProc | DLGPROC | 8/4 | +40 | +24 | ページのダイアログプロシージャへのポインタ。 | ||||||||||||||||||||||||||||||
| lParam | LPARAM | 8/4 | +48 | +28 | アプリケーション定義データ。ダイアログプロシージャに渡される。 | ||||||||||||||||||||||||||||||
| pfnCallback | LPFNPSPCALLBACKA | 8/4 | +56 | +32 | ページの作成/破棄時に呼ばれるコールバック関数へのポインタ。 | ||||||||||||||||||||||||||||||
| pcRefParent | DWORD* | 8/4 | +64 | +36 | 親のプロパティシートの参照カウントへのポインタ。PSP_USEREFPARENT時に使う。 | ||||||||||||||||||||||||||||||
| pszHeaderTitle | LPSTR | 8/4 | +72 | +40 | Version 5.80 以降。ヘッダー領域のタイトルです。Wizard97 スタイルのウィザードでこのメンバーを使用するには、次の操作も行う必要があります。
| ||||||||||||||||||||||||||||||
| pszHeaderSubTitle | LPSTR | 8/4 | +80 | +44 | Version 5.80。ヘッダー領域のサブタイトルです。このメンバーを使用するには、次の操作を行う必要があります。
注 このメンバーは、Aero スタイルのウィザード (PSH_AEROWIZARD) を使用する場合は無視されます。
| ||||||||||||||||||||||||||||||
| hActCtx | HANDLE | 8/4 | +88 | +48 | Version 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 メンバーは、アプリケーション固有の情報をダイアログ ボックス プロシージャに渡せるようにするために用意されています。ページ自体には影響しません。詳細については、「Property Sheet Creation」を参照してください。 - 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 | LPSTR | 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 | LPSTR | 8/4 | +0 | +0 |
公式ドキュメント
プロパティ シート内のページを定義します。
この構造体は、コード内で直接使用することを意図したものではありません。代わりに PROPSHEETPAGE 構造体を使用してください。
解説(Remarks)
Comctl32.dll のバージョン 6 以降は再頒布できません。Comctl32.dll のバージョン 6 以降を使用するには、マニフェストで .dll ファイルを指定します。マニフェストの詳細については、「Enabling Visual Styles」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PROPSHEETPAGEA_V3 (x64 96 / x86 52 バイト)
typedef struct PROPSHEETPAGEA_V3 {
DWORD dwSize;
DWORD dwFlags;
HINSTANCE hInstance;
_Anonymous1_e__Union Anonymous1;
_Anonymous2_e__Union Anonymous2;
LPSTR pszTitle;
DLGPROC pfnDlgProc;
LPARAM lParam;
LPFNPSPCALLBACKA pfnCallback;
DWORD* pcRefParent;
LPSTR pszHeaderTitle;
LPSTR pszHeaderSubTitle;
HANDLE hActCtx;
} PROPSHEETPAGEA_V3;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROPSHEETPAGEA_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 PROPSHEETPAGEA_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 PROPSHEETPAGEA_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 PROPSHEETPAGEA_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 PROPSHEETPAGEA_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
PROPSHEETPAGEA_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 PROPSHEETPAGEA_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
PROPSHEETPAGEA_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 PROPSHEETPAGEA_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 レイアウト)
; PROPSHEETPAGEA_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 : LPSTR (+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 : LPFNPSPCALLBACKA (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pcRefParent : DWORD* (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; pszHeaderTitle : LPSTR (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; pszHeaderSubTitle : LPSTR (+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 レイアウト)
; PROPSHEETPAGEA_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 : LPSTR (+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 : LPFNPSPCALLBACKA (+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 : LPSTR (+72, 8byte) qpoke st,72,値 / qpeek(st,72) ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; pszHeaderSubTitle : LPSTR (+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 PROPSHEETPAGEA_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, PROPSHEETPAGEA_V3 ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。