Win32 API 日本語リファレンス
ホームUI.Controls › PROPSHEETPAGEW_V3

PROPSHEETPAGEW_V3

構造体
サイズx64: 96 バイト / x86: 52 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で指定する。バージョンを示す。
dwFlagsDWORD4+4+4ページの動作を制御するPSP_系フラグの組み合わせ。
hInstanceHINSTANCE8/4+8+8ダイアログテンプレートやアイコンを含むモジュールのハンドル。
Anonymous1_Anonymous1_e__Union8/4+16+12ダイアログテンプレートを指定する共用体。リソース名またはメモリ内テンプレートを保持する。
Anonymous2_Anonymous2_e__Union8/4+24+16ページのアイコンを指定する共用体。アイコンハンドルまたはリソース識別子を保持する。
pszTitleLPWSTR8/4+32+20PSP_USETITLE指定時にタブに表示するページのタイトル文字列。
pfnDlgProcDLGPROC8/4+40+24ページのダイアログプロシージャへのポインタ。
lParamLPARAM8/4+48+28アプリケーション定義データ。ダイアログプロシージャに渡される。
pfnCallbackLPFNPSPCALLBACKW8/4+56+32ページの作成/破棄時に呼ばれるコールバック関数へのポインタ。
pcRefParentDWORD*8/4+64+36親のプロパティシートの参照カウントへのポインタ。PSP_USEREFPARENT時に使う。
pszHeaderTitleLPWSTR8/4+72+40ウィザード97スタイルのヘッダタイトル文字列。PSP_USEHEADERTITLE時に使う。
pszHeaderSubTitleLPWSTR8/4+80+44ウィザード97スタイルのヘッダ副題文字列。PSP_USEHEADERSUBTITLE時に使う。
hActCtxHANDLE8/4+88+48ページ作成時に使うアクティベーションコンテキストのハンドル。

共用体: _Anonymous1_e__Union x64 8B / x86 4B

フィールドサイズx64x86
pszTemplateLPWSTR8/4+0+0
pResourceDLGTEMPLATE*8/4+0+0

共用体: _Anonymous2_e__Union x64 8B / x86 4B

フィールドサイズx64x86
hIconHICON8/4+0+0
pszIconLPWSTR8/4+0+0

各言語での定義

#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 Structure
import 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: pointer
struct 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 非対応)。必要に応じ手動でアクセス。