Win32 API 日本語リファレンス
ホームGraphics.Printing › CPSUICBPARAM

CPSUICBPARAM

構造体
サイズx64: 64 バイト / x86: 32 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeWORD2+0+0本構造体のサイズ(バイト単位)。
ReasonWORD2+2+2コールバックが呼ばれた理由を示す値(CPSUICB_REASON_*)。
hDlgHWND8/4+8+4プロパティシートダイアログのウィンドウハンドル。
pOptItemOPTITEM*8/4+16+8オプション項目配列(OPTITEM)の先頭へのポインタ。
cOptItemWORD2+24+12pOptItem配列に含まれる項目数。
FlagsWORD2+26+14コールバック動作を制御するビットフラグ。
pCurItemOPTITEM*8/4+32+16コールバック対象となる現在の項目へのポインタ。
Anonymous_Anonymous_e__Union8/4+40+20選択値や旧選択値を保持する無名共用体。
UserDataUINT_PTR8/4+48+24アプリケーション定義のユーザーデータ。
ResultUINT_PTR8/4+56+28コールバックの処理結果を返すフィールド。

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

フィールドサイズx64x86
OldSelINT4+0+0
pOldSelCHAR*8/4+0+0

各言語での定義

#include <windows.h>

// CPSUICBPARAM  (x64 64 / x86 32 バイト)
typedef struct CPSUICBPARAM {
    WORD cbSize;
    WORD Reason;
    HWND hDlg;
    OPTITEM* pOptItem;
    WORD cOptItem;
    WORD Flags;
    OPTITEM* pCurItem;
    _Anonymous_e__Union Anonymous;
    UINT_PTR UserData;
    UINT_PTR Result;
} CPSUICBPARAM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CPSUICBPARAM
{
    public ushort cbSize;
    public ushort Reason;
    public IntPtr hDlg;
    public IntPtr pOptItem;
    public ushort cOptItem;
    public ushort Flags;
    public IntPtr pCurItem;
    public _Anonymous_e__Union Anonymous;
    public UIntPtr UserData;
    public UIntPtr Result;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CPSUICBPARAM
    Public cbSize As UShort
    Public Reason As UShort
    Public hDlg As IntPtr
    Public pOptItem As IntPtr
    Public cOptItem As UShort
    Public Flags As UShort
    Public pCurItem As IntPtr
    Public Anonymous As _Anonymous_e__Union
    Public UserData As UIntPtr
    Public Result As UIntPtr
End Structure
import ctypes
from ctypes import wintypes

class CPSUICBPARAM(ctypes.Structure):
    _fields_ = [
        ("cbSize", ctypes.c_ushort),
        ("Reason", ctypes.c_ushort),
        ("hDlg", ctypes.c_void_p),
        ("pOptItem", ctypes.c_void_p),
        ("cOptItem", ctypes.c_ushort),
        ("Flags", ctypes.c_ushort),
        ("pCurItem", ctypes.c_void_p),
        ("Anonymous", _Anonymous_e__Union),
        ("UserData", ctypes.c_size_t),
        ("Result", ctypes.c_size_t),
    ]
#[repr(C)]
pub struct CPSUICBPARAM {
    pub cbSize: u16,
    pub Reason: u16,
    pub hDlg: *mut core::ffi::c_void,
    pub pOptItem: *mut core::ffi::c_void,
    pub cOptItem: u16,
    pub Flags: u16,
    pub pCurItem: *mut core::ffi::c_void,
    pub Anonymous: _Anonymous_e__Union,
    pub UserData: usize,
    pub Result: usize,
}
import "golang.org/x/sys/windows"

type CPSUICBPARAM struct {
	cbSize uint16
	Reason uint16
	hDlg uintptr
	pOptItem uintptr
	cOptItem uint16
	Flags uint16
	pCurItem uintptr
	Anonymous _Anonymous_e__Union
	UserData uintptr
	Result uintptr
}
type
  CPSUICBPARAM = record
    cbSize: Word;
    Reason: Word;
    hDlg: Pointer;
    pOptItem: Pointer;
    cOptItem: Word;
    Flags: Word;
    pCurItem: Pointer;
    Anonymous: _Anonymous_e__Union;
    UserData: NativeUInt;
    Result: NativeUInt;
  end;
const CPSUICBPARAM = extern struct {
    cbSize: u16,
    Reason: u16,
    hDlg: ?*anyopaque,
    pOptItem: ?*anyopaque,
    cOptItem: u16,
    Flags: u16,
    pCurItem: ?*anyopaque,
    Anonymous: _Anonymous_e__Union,
    UserData: usize,
    Result: usize,
};
type
  CPSUICBPARAM {.bycopy.} = object
    cbSize: uint16
    Reason: uint16
    hDlg: pointer
    pOptItem: pointer
    cOptItem: uint16
    Flags: uint16
    pCurItem: pointer
    Anonymous: _Anonymous_e__Union
    UserData: uint
    Result: uint
struct CPSUICBPARAM
{
    ushort cbSize;
    ushort Reason;
    void* hDlg;
    void* pOptItem;
    ushort cOptItem;
    ushort Flags;
    void* pCurItem;
    _Anonymous_e__Union Anonymous;
    size_t UserData;
    size_t Result;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CPSUICBPARAM サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbSize : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; Reason : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; hDlg : HWND (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pOptItem : OPTITEM* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; cOptItem : WORD (+12, 2byte)  wpoke st,12,値  /  値 = wpeek(st,12)
; Flags : WORD (+14, 2byte)  wpoke st,14,値  /  値 = wpeek(st,14)
; pCurItem : OPTITEM* (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; Anonymous : _Anonymous_e__Union (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; UserData : UINT_PTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Result : UINT_PTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CPSUICBPARAM サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; cbSize : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; Reason : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; hDlg : HWND (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pOptItem : OPTITEM* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; cOptItem : WORD (+24, 2byte)  wpoke st,24,値  /  値 = wpeek(st,24)
; Flags : WORD (+26, 2byte)  wpoke st,26,値  /  値 = wpeek(st,26)
; pCurItem : OPTITEM* (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; Anonymous : _Anonymous_e__Union (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; UserData : UINT_PTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; Result : UINT_PTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CPSUICBPARAM
    #field short cbSize
    #field short Reason
    #field intptr hDlg
    #field intptr pOptItem
    #field short cOptItem
    #field short Flags
    #field intptr pCurItem
    #field byte Anonymous 8
    #field intptr UserData
    #field intptr Result
#endstruct

stdim st, CPSUICBPARAM        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。