Win32 API 日本語リファレンス
ホームNetworking.ActiveDirectory › CQPAGE

CQPAGE

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

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

フィールド

フィールドサイズx64x86説明
cbStructDWORD4+0+0構造体のサイズをバイト単位で格納します。
dwFlagsDWORD4+4+4予約済みです。このメンバーは 0 でなければなりません。
pPageProcLPCQPAGEPROC8/4+8+8クエリ フォーム拡張機能が定義するクエリ ページ コールバック関数へのポインターです。このコールバック関数は、ページ内で発生したイベントを拡張機能に通知するために使用され、CQPageProc コールバック関数の形式を取ります。
hInstanceHINSTANCE8/4+16+12idPageName メンバーおよび idPageTemplate メンバーで識別されるリソースを含むモジュールのインスタンス ハンドルを格納します。
idPageNameINT4+24+16ページのタイトルに使用される、hInstance 内の文字列リソースの識別子を格納します。
idPageTemplateINT4+28+20ページのダイアログに使用される、hInstance 内のダイアログ リソースの識別子を格納します。
pDlgProcDLGPROC8/4+32+24ダイアログ ボックス プロシージャへのポインターです。詳細については、DialogProc を参照してください。
lParamLPARAM8/4+40+28CQPageProc コールバック関数の pPage パラメーターとして渡される CQPAGE 構造体の lParam メンバーで渡される、拡張機能が定義する 32 ビット値です。

公式ドキュメント

CQPAGE 構造体は、CQAddPagesProc コールバック関数によってクエリ ダイアログ ボックス内のフォームに追加されるクエリ ページを定義するために使用されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CQPAGE  (x64 48 / x86 32 バイト)
typedef struct CQPAGE {
    DWORD cbStruct;
    DWORD dwFlags;
    LPCQPAGEPROC pPageProc;
    HINSTANCE hInstance;
    INT idPageName;
    INT idPageTemplate;
    DLGPROC pDlgProc;
    LPARAM lParam;
} CQPAGE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CQPAGE
{
    public uint cbStruct;
    public uint dwFlags;
    public IntPtr pPageProc;
    public IntPtr hInstance;
    public int idPageName;
    public int idPageTemplate;
    public IntPtr pDlgProc;
    public IntPtr lParam;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CQPAGE
    Public cbStruct As UInteger
    Public dwFlags As UInteger
    Public pPageProc As IntPtr
    Public hInstance As IntPtr
    Public idPageName As Integer
    Public idPageTemplate As Integer
    Public pDlgProc As IntPtr
    Public lParam As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CQPAGE(ctypes.Structure):
    _fields_ = [
        ("cbStruct", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("pPageProc", ctypes.c_void_p),
        ("hInstance", ctypes.c_void_p),
        ("idPageName", ctypes.c_int),
        ("idPageTemplate", ctypes.c_int),
        ("pDlgProc", ctypes.c_void_p),
        ("lParam", ctypes.c_ssize_t),
    ]
#[repr(C)]
pub struct CQPAGE {
    pub cbStruct: u32,
    pub dwFlags: u32,
    pub pPageProc: *mut core::ffi::c_void,
    pub hInstance: *mut core::ffi::c_void,
    pub idPageName: i32,
    pub idPageTemplate: i32,
    pub pDlgProc: *mut core::ffi::c_void,
    pub lParam: isize,
}
import "golang.org/x/sys/windows"

type CQPAGE struct {
	cbStruct uint32
	dwFlags uint32
	pPageProc uintptr
	hInstance uintptr
	idPageName int32
	idPageTemplate int32
	pDlgProc uintptr
	lParam uintptr
}
type
  CQPAGE = record
    cbStruct: DWORD;
    dwFlags: DWORD;
    pPageProc: Pointer;
    hInstance: Pointer;
    idPageName: Integer;
    idPageTemplate: Integer;
    pDlgProc: Pointer;
    lParam: NativeInt;
  end;
const CQPAGE = extern struct {
    cbStruct: u32,
    dwFlags: u32,
    pPageProc: ?*anyopaque,
    hInstance: ?*anyopaque,
    idPageName: i32,
    idPageTemplate: i32,
    pDlgProc: ?*anyopaque,
    lParam: isize,
};
type
  CQPAGE {.bycopy.} = object
    cbStruct: uint32
    dwFlags: uint32
    pPageProc: pointer
    hInstance: pointer
    idPageName: int32
    idPageTemplate: int32
    pDlgProc: pointer
    lParam: int
struct CQPAGE
{
    uint cbStruct;
    uint dwFlags;
    void* pPageProc;
    void* hInstance;
    int idPageName;
    int idPageTemplate;
    void* pDlgProc;
    ptrdiff_t lParam;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CQPAGE サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pPageProc : LPCQPAGEPROC (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; hInstance : HINSTANCE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; idPageName : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; idPageTemplate : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pDlgProc : DLGPROC (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lParam : LPARAM (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CQPAGE サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pPageProc : LPCQPAGEPROC (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; hInstance : HINSTANCE (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; idPageName : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; idPageTemplate : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pDlgProc : DLGPROC (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lParam : LPARAM (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CQPAGE
    #field int cbStruct
    #field int dwFlags
    #field intptr pPageProc
    #field intptr hInstance
    #field int idPageName
    #field int idPageTemplate
    #field intptr pDlgProc
    #field intptr lParam
#endstruct

stdim st, CQPAGE        ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct