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

PRINTDLGA

構造体
サイズx64: 114 バイト / x86: 66 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
lStructSizeDWORD4+0+0構造体のサイズ (バイト単位)。
hwndOwnerHWND8/4+4+4ダイアログ ボックスを所有するウィンドウへのハンドル。このメンバーには任意の有効なウィンドウ ハンドルを指定できます。ダイアログ ボックスに所有者がない場合は NULL を指定できます。
hDevModeHGLOBAL8/4+12+8

DEVMODE 構造体を格納する移動可能なグローバル メモリ オブジェクトへのハンドル。入力時に hDevModeNULL でない場合は、DEVMODE 構造体用の移動可能なメモリ ブロックを割り当て、そのメンバーを初期化する必要があります。PrintDlg 関数は、この入力データを使用してダイアログ ボックス内のコントロールを初期化します。PrintDlg から制御が戻ると、DEVMODE のメンバーはユーザーの入力内容を示します。

入力時に hDevModeNULL の場合、PrintDlgDEVMODE 構造体用のメモリを割り当て、そのメンバーをユーザーの入力内容を示すように初期化して、それを識別するハンドルを返します。

指定されたプリンターのデバイス ドライバーが拡張デバイス モードをサポートしていない場合、PrintDlg から制御が戻ったときの hDevModeNULL になります。

デバイス名 (DEVMODE 構造体の dmDeviceName メンバーで指定) が WIN.INI の [devices] セクションに存在しない場合、PrintDlg はエラーを返します。

hDevMode メンバーと hDevNames メンバーの詳細については、このトピック末尾の「解説」セクションを参照してください。

hDevNamesHGLOBAL8/4+20+12

DEVNAMES 構造体を格納する移動可能なグローバル メモリ オブジェクトへのハンドル。入力時に hDevNamesNULL でない場合は、DEVNAMES 構造体用の移動可能なメモリ ブロックを割り当て、そのメンバーを初期化する必要があります。PrintDlg 関数は、この入力データを使用してダイアログ ボックス内のコントロールを初期化します。PrintDlg から制御が戻ると、DEVNAMES のメンバーにはユーザーが選択したプリンターの情報が格納されます。この情報を使用して、デバイス コンテキストまたは情報コンテキストを作成できます。

hDevNames メンバーは NULL でもかまいません。その場合、PrintDlgDEVNAMES 構造体用のメモリを割り当て、そのメンバーをユーザーの入力内容を示すように初期化して、それを識別するハンドルを返します。

hDevMode メンバーと hDevNames メンバーの詳細については、このトピック末尾の「解説」セクションを参照してください。

hDCHDC8/4+28+16Flags メンバーで PD_RETURNDCPC_RETURNIC のどちらのフラグが指定されているかに応じた、デバイス コンテキストまたは情報コンテキストへのハンドル。どちらのフラグも指定されていない場合、このメンバーの値は未定義です。両方のフラグが指定されている場合は PD_RETURNDC が優先されます。
FlagsPRINTDLGEX_FLAGS4+36+20

Print ダイアログ ボックスを初期化します。ダイアログ ボックスから制御が戻ると、これらのフラグはユーザーの入力内容を示すように設定されます。このメンバーには次の値の 1 つ以上を指定できます。

意味
PD_ALLPAGES
0x00000000
既定のフラグで、All ラジオ ボタンが最初に選択されていることを示します。このフラグは、PD_PAGENUMS フラグと PD_SELECTION フラグが指定されていないことを示すプレースホルダーとして使用されます。
PD_COLLATE
0x00000010
このフラグが設定されている場合、Collate チェック ボックスが選択されます。

PrintDlg 関数から制御が戻ったときにこのフラグが設定されている場合、アプリケーションは複数部の丁合いを自分でシミュレートする必要があります。詳細については、PD_USEDEVMODECOPIESANDCOLLATE フラグの説明を参照してください。

PD_NOPAGENUMS を参照してください。

PD_DISABLEPRINTTOFILE
0x00080000
Print to File チェック ボックスを無効にします。
PD_ENABLEPRINTHOOK
0x00001000
lpfnPrintHook メンバーで指定されたフック プロシージャを有効にします。これにより、Print ダイアログ ボックス用のフック プロシージャが有効になります。
PD_ENABLEPRINTTEMPLATE
0x00004000
hInstance メンバーと lpPrintTemplateName メンバーが、既定の Print ダイアログ ボックス テンプレートに代わるテンプレートを指定することを示します。
PD_ENABLEPRINTTEMPLATEHANDLE
0x00010000
hPrintTemplate メンバーが、あらかじめ読み込まれたダイアログ ボックス テンプレートを含むデータ ブロックを識別することを示します。このテンプレートは、Print ダイアログ ボックスの既定のテンプレートに置き換わります。このフラグが指定されている場合、システムは lpPrintTemplateName メンバーを無視します。
PD_ENABLESETUPHOOK
0x00002000
lpfnSetupHook メンバーで指定されたフック プロシージャを有効にします。これにより、Print Setup ダイアログ ボックス用のフック プロシージャが有効になります。
PD_ENABLESETUPTEMPLATE
0x00008000
hInstance メンバーと lpSetupTemplateName メンバーが、既定の Print Setup ダイアログ ボックス テンプレートに代わるテンプレートを指定することを示します。
PD_ENABLESETUPTEMPLATEHANDLE
0x00020000
hSetupTemplate メンバーが、あらかじめ読み込まれたダイアログ ボックス テンプレートを含むデータ ブロックを識別することを示します。このテンプレートは、Print Setup ダイアログ ボックスの既定のテンプレートに置き換わります。このフラグが指定されている場合、システムは lpSetupTemplateName メンバーを無視します。
PD_HIDEPRINTTOFILE
0x00100000
Print to File チェック ボックスを非表示にします。
PD_NONETWORKBUTTON
0x00200000
Network ボタンを非表示にし、無効にします。
PD_NOPAGENUMS
0x00000008
Pages ラジオ ボタンおよび関連するエディット コントロールを無効にします。また、Collate チェック ボックスがダイアログに表示されるようになります。
PD_NOSELECTION
0x00000004
Selection ラジオ ボタンを無効にします。
PD_NOWARNING
0x00000080
既定のプリンターが存在しない場合に警告メッセージが表示されないようにします。
PD_PAGENUMS
0x00000002
このフラグが設定されている場合、Pages ラジオ ボタンが選択されます。PrintDlg 関数から制御が戻ったときにこのフラグが設定されている場合、nFromPage メンバーと nToPage メンバーは、ユーザーが指定した開始ページと終了ページを示します。
PD_PRINTSETUP
0x00000040
Print ダイアログ ボックスではなく Print Setup ダイアログ ボックスをシステムに表示させます。
PD_PRINTTOFILE
0x00000020
このフラグが設定されている場合、Print to File チェック ボックスが選択されます。PrintDlg 関数から制御が戻ったときにこのフラグが設定されている場合、DEVNAMES 構造体の wOutputOffset メンバーが示すオフセットには文字列 "FILE:" が格納されます。印刷処理を開始するために StartDoc 関数を呼び出すときは、DOCINFO 構造体の lpszOutput メンバーにこの "FILE:" 文字列を指定します。この文字列を指定すると、印刷サブシステムはユーザーに出力ファイルの名前を問い合わせます。
PD_RETURNDC
0x00000100
ユーザーがダイアログ ボックスで行った選択に一致するデバイス コンテキストを PrintDlg に返させます。デバイス コンテキストは hDC に返されます。
PD_RETURNDEFAULT
0x00000400
このフラグが設定されている場合、PrintDlg 関数はダイアログ ボックスを表示しません。代わりに、システムの既定のプリンター用に初期化された DEVMODE 構造体および DEVNAMES 構造体へのハンドルを hDevNames メンバーと hDevMode メンバーに設定します。hDevNameshDevMode はどちらも NULL でなければなりません。そうでない場合、PrintDlg はエラーを返します。
PD_RETURNIC
0x00000200
PD_RETURNDC フラグと似ていますが、デバイス コンテキストではなく情報コンテキストを返します。PD_RETURNDCPD_RETURNIC のどちらも指定されていない場合、出力時の hDC は未定義です。
PD_SELECTION
0x00000001
このフラグが設定されている場合、Selection ラジオ ボタンが選択されます。PD_PAGENUMSPD_SELECTION のどちらも設定されていない場合は、All ラジオ ボタンが選択されます。
PD_SHOWHELP
0x00000800
ダイアログ ボックスに Help ボタンを表示させます。hwndOwner メンバーには、ユーザーが Help ボタンをクリックしたときにダイアログ ボックスが送信する HELPMSGSTRING 登録メッセージを受け取るウィンドウを指定する必要があります。
PD_USEDEVMODECOPIES
0x00040000
PD_USEDEVMODECOPIESANDCOLLATE と同じです。
PD_USEDEVMODECOPIESANDCOLLATE
0x00040000
このフラグは、アプリケーションが複数部の印刷と丁合いをサポートしているかどうかを示します。アプリケーションが複数部の印刷と丁合いをサポートしていないことを示すには、入力時にこのフラグを設定します。この場合、PRINTDLG 構造体の nCopies メンバーは常に 1 を返し、Flags メンバーに PD_COLLATE が設定されることはありません。

このフラグが設定されていない場合、複数部の印刷と丁合いはアプリケーションの責任になります。この場合、PRINTDLG 構造体の nCopies メンバーはユーザーが印刷しようとしている部数を示し、Flags メンバーの PD_COLLATE フラグはユーザーが丁合いを希望しているかどうかを示します。

このフラグが設定されているかどうかにかかわらず、アプリケーションは nCopiesPD_COLLATE から、描画すべき部数と、丁合いして印刷するかどうかを判断できます。

このフラグが設定されていて、プリンター ドライバーが複数部の印刷をサポートしていない場合、Copies エディット コントロールは無効になります。同様に、このフラグが設定されていて、プリンター ドライバーが丁合いをサポートしていない場合、Collate チェック ボックスは無効になります。

DEVMODE 構造体の dmCopies メンバーと dmCollate メンバーには、プリンター ドライバーが使用する部数と丁合いの情報が格納されます。このフラグが設定されていて、プリンター ドライバーが複数部の印刷をサポートしている場合、dmCopies メンバーはユーザーが要求した部数を示します。このフラグが設定されていて、プリンター ドライバーが丁合いをサポートしている場合、DEVMODE 構造体の dmCollate メンバーはユーザーが丁合いを希望しているかどうかを示します。このフラグが設定されていない場合、dmCopies メンバーは常に 1 を返し、dmCollate メンバーは常に 0 になります。

Windows 2000/XP/2003 における既知の問題: PrintDlg を呼び出す前にこのフラグを設定していない場合、PrintDlg は制御を返すときに nCopiesdmCopies の値を入れ替えることがあります。この問題の回避策として、PrintDlg から制御が戻ったときに実際に印刷される部数を取得するには、dmCopies の値が 1 より大きい場合は dmCopies を、そうでない場合は nCopies を使用します。

PrintDlg または PrintDlgExDEVMODE 構造体の dmCopies メンバーと dmCollate メンバーに正しい値を返すようにするには、PD_RETURNDC = TRUE および PD_USEDEVMODECOPIESANDCOLLATE = TRUE を設定します。この場合、PRINTDLG 構造体の nCopies メンバーは常に 1 になり、PD_COLLATE は常に FALSE になります。

PrintDlg または PrintDlgExnCopiesPD_COLLATE に正しい値を返すようにするには、PD_RETURNDC = TRUE および PD_USEDEVMODECOPIESANDCOLLATE = FALSE を設定します。この場合、dmCopies は常に 1 になり、dmCollate は常に FALSE になります。

Windows Vista および Windows 7 では、PD_RETURNDCTRUEPD_USEDEVMODECOPIESANDCOLLATEFALSE に設定して PrintDlg または PrintDlgEx を呼び出すと、PrintDlg 関数または PrintDlgEx 関数は PRINTDLG 構造体の nCopies メンバーに部数を設定し、さらに PRINTDLG 構造体の hDC メンバーが表す構造体にも部数を設定します。

GDI を呼び出すときは、重複した部数が印刷されないように、nCopies の値を無視して 1 とみなし、返された hDC を使用する必要があります。

nFromPageWORD2+40+24

開始ページのエディット コントロールの初期値。

PrintDlg から制御が戻ると、nFromPage はユーザーが指定した開始ページになります。ユーザーが Okay ボタンをクリックしたときに Pages ラジオ ボタンが選択されていた場合、PrintDlgPD_PAGENUMS フラグを設定し、ユーザーが最小ページから最大ページの範囲内の開始ページ値を入力するまで制御を返しません。

nFromPage または nToPage の入力値が最小値/最大値の範囲外の場合、PrintDlgPD_PAGENUMS フラグが指定されているときにかぎりエラーを返します。それ以外の場合は、ダイアログ ボックスを表示しますが、範囲外の値を最小値または最大値に変更します。

nToPageWORD2+42+26終了ページのエディット コントロールの初期値。PrintDlg から制御が戻ると、nToPage はユーザーが指定した終了ページになります。ユーザーが Okay ボタンをクリックしたときに Pages ラジオ ボタンが選択されていた場合、PrintDlgPD_PAGENUMS フラグを設定し、ユーザーが最小ページから最大ページの範囲内の終了ページ値を入力するまで制御を返しません。
nMinPageWORD2+44+28From ページと To ページのエディット コントロールで指定できるページ範囲の最小値。nMinPagenMaxPage と等しい場合、Pages ラジオ ボタンと、開始ページおよび終了ページのエディット コントロールは無効になります。
nMaxPageWORD2+46+30From ページと To ページのエディット コントロールで指定できるページ範囲の最大値。
nCopiesWORD2+48+32hDevModeNULL の場合の Copies エディット コントロールの初期部数。NULL でない場合は、DEVMODE 構造体の dmCopies メンバーが初期値を保持します。PrintDlg から制御が戻ると、nCopies には実際に印刷する部数が格納されます。この値は、複数部の印刷をアプリケーションとプリンター ドライバーのどちらが担当するかによって異なります。Flags メンバーに PD_USEDEVMODECOPIESANDCOLLATE フラグが設定されている場合、戻り時の nCopies は常に 1 であり、複数部の印刷はプリンター ドライバーが担当します。このフラグが設定されていない場合、nCopies で指定された部数の印刷はアプリケーションが担当します。詳細については、PD_USEDEVMODECOPIESANDCOLLATE フラグの説明を参照してください。
hInstanceHINSTANCE8/4+50+34Flags メンバーに PD_ENABLEPRINTTEMPLATE フラグまたは PD_ENABLESETUPTEMPLATE フラグが設定されている場合、hInstance は、lpPrintTemplateName メンバーまたは lpSetupTemplateName メンバーで指定された名前のダイアログ ボックス テンプレートを含むアプリケーションまたはモジュールのインスタンスへのハンドルです。
lCustDataLPARAM8/4+58+38lpfnPrintHook メンバーまたは lpfnSetupHook メンバーで識別されるフック プロシージャに、システムが渡すアプリケーション定義のデータ。システムがフック プロシージャに WM_INITDIALOG メッセージを送信するとき、メッセージの lParam パラメーターは、ダイアログの作成時に指定された PRINTDLG 構造体へのポインターになります。フック プロシージャはこのポインターを使用して lCustData の値を取得できます。
lpfnPrintHookLPPRINTHOOKPROC8/4+66+42Print ダイアログ ボックス宛てのメッセージを処理できる PrintHookProc フック プロシージャへのポインター。このメンバーは、Flags メンバーに PD_ENABLEPRINTHOOK フラグが設定されていない限り無視されます。
lpfnSetupHookLPSETUPHOOKPROC8/4+74+46Print Setup ダイアログ ボックス宛てのメッセージを処理できる SetupHookProc フック プロシージャへのポインター。このメンバーは、Flags メンバーに PD_ENABLESETUPHOOK フラグが設定されていない限り無視されます。
lpPrintTemplateNameLPSTR8/4+82+50hInstance メンバーで識別されるモジュール内にあるダイアログ ボックス テンプレート リソースの名前。このテンプレートは、既定の Print ダイアログ ボックス テンプレートに置き換わります。このメンバーは、Flags メンバーに PD_ENABLEPRINTTEMPLATE フラグが設定されていない限り無視されます。
lpSetupTemplateNameLPSTR8/4+90+54hInstance メンバーで識別されるモジュール内にあるダイアログ ボックス テンプレート リソースの名前。このテンプレートは、既定の Print Setup ダイアログ ボックス テンプレートに置き換わります。このメンバーは、Flags メンバーに PD_ENABLESETUPTEMPLATE フラグが設定されていない限り無視されます。
hPrintTemplateHGLOBAL8/4+98+58Flags メンバーに PD_ENABLEPRINTTEMPLATEHANDLE フラグが設定されている場合、hPrintTemplate はダイアログ ボックス テンプレートを格納するメモリ オブジェクトへのハンドルです。このテンプレートは、既定の Print ダイアログ ボックス テンプレートに置き換わります。
hSetupTemplateHGLOBAL8/4+106+62Flags メンバーに PD_ENABLESETUPTEMPLATEHANDLE フラグが設定されている場合、hSetupTemplate はダイアログ ボックス テンプレートを格納するメモリ オブジェクトへのハンドルです。このテンプレートは、既定の Print Setup ダイアログ ボックス テンプレートに置き換わります。

公式ドキュメント

PrintDlg 関数が 印刷ダイアログ ボックス の初期化に使用する情報を格納します。ユーザーがダイアログ ボックスを閉じると、システムはこの構造体を使用してユーザーの選択に関する情報を返します。

解説(Remarks)

hDevModehDevNames の両方が NULL の場合、PrintDlg は現在の既定のプリンターを使用してダイアログ ボックスを初期化します。別のプリンター用にダイアログ ボックスを初期化するには、DEVNAMES 構造体の wDeviceOffset メンバーでプリンター名を指定します。

なお、DEVMODE 構造体の dmDeviceName メンバーでもプリンター名を指定できます。ただし、dmDeviceName は 32 文字までに制限されているのに対し、wDeviceOffset の名前には制限がありません。wDeviceOffsetdmDeviceName の名前が異なる場合、PrintDlgwDeviceOffset で指定されたプリンターを使用してダイアログ ボックスを初期化します。

PD_RETURNDEFAULT フラグが設定されていて、hDevModehDevNames の両方が NULL の場合、PrintDlg はダイアログ ボックスを表示せずに、hDevNames メンバーと hDevMode メンバーを使用して現在の既定のプリンターに関する情報を返します。

メモ

commdlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして PRINTDLG を定義しています。エンコード中立のエイリアスを、エンコード中立でないコードと混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因になることがあります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// PRINTDLGA  (x64 114 / x86 66 バイト)
#pragma pack(push, 1)
typedef struct PRINTDLGA {
    DWORD lStructSize;
    HWND hwndOwner;
    HGLOBAL hDevMode;
    HGLOBAL hDevNames;
    HDC hDC;
    PRINTDLGEX_FLAGS Flags;
    WORD nFromPage;
    WORD nToPage;
    WORD nMinPage;
    WORD nMaxPage;
    WORD nCopies;
    HINSTANCE hInstance;
    LPARAM lCustData;
    LPPRINTHOOKPROC lpfnPrintHook;
    LPSETUPHOOKPROC lpfnSetupHook;
    LPSTR lpPrintTemplateName;
    LPSTR lpSetupTemplateName;
    HGLOBAL hPrintTemplate;
    HGLOBAL hSetupTemplate;
} PRINTDLGA;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct PRINTDLGA
{
    public uint lStructSize;
    public IntPtr hwndOwner;
    public IntPtr hDevMode;
    public IntPtr hDevNames;
    public IntPtr hDC;
    public uint Flags;
    public ushort nFromPage;
    public ushort nToPage;
    public ushort nMinPage;
    public ushort nMaxPage;
    public ushort nCopies;
    public IntPtr hInstance;
    public IntPtr lCustData;
    public IntPtr lpfnPrintHook;
    public IntPtr lpfnSetupHook;
    public IntPtr lpPrintTemplateName;
    public IntPtr lpSetupTemplateName;
    public IntPtr hPrintTemplate;
    public IntPtr hSetupTemplate;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure PRINTDLGA
    Public lStructSize As UInteger
    Public hwndOwner As IntPtr
    Public hDevMode As IntPtr
    Public hDevNames As IntPtr
    Public hDC As IntPtr
    Public Flags As UInteger
    Public nFromPage As UShort
    Public nToPage As UShort
    Public nMinPage As UShort
    Public nMaxPage As UShort
    Public nCopies As UShort
    Public hInstance As IntPtr
    Public lCustData As IntPtr
    Public lpfnPrintHook As IntPtr
    Public lpfnSetupHook As IntPtr
    Public lpPrintTemplateName As IntPtr
    Public lpSetupTemplateName As IntPtr
    Public hPrintTemplate As IntPtr
    Public hSetupTemplate As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class PRINTDLGA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("lStructSize", wintypes.DWORD),
        ("hwndOwner", ctypes.c_void_p),
        ("hDevMode", ctypes.c_void_p),
        ("hDevNames", ctypes.c_void_p),
        ("hDC", ctypes.c_void_p),
        ("Flags", wintypes.DWORD),
        ("nFromPage", ctypes.c_ushort),
        ("nToPage", ctypes.c_ushort),
        ("nMinPage", ctypes.c_ushort),
        ("nMaxPage", ctypes.c_ushort),
        ("nCopies", ctypes.c_ushort),
        ("hInstance", ctypes.c_void_p),
        ("lCustData", ctypes.c_ssize_t),
        ("lpfnPrintHook", ctypes.c_void_p),
        ("lpfnSetupHook", ctypes.c_void_p),
        ("lpPrintTemplateName", ctypes.c_void_p),
        ("lpSetupTemplateName", ctypes.c_void_p),
        ("hPrintTemplate", ctypes.c_void_p),
        ("hSetupTemplate", ctypes.c_void_p),
    ]
#[repr(C, packed(1))]
pub struct PRINTDLGA {
    pub lStructSize: u32,
    pub hwndOwner: *mut core::ffi::c_void,
    pub hDevMode: *mut core::ffi::c_void,
    pub hDevNames: *mut core::ffi::c_void,
    pub hDC: *mut core::ffi::c_void,
    pub Flags: u32,
    pub nFromPage: u16,
    pub nToPage: u16,
    pub nMinPage: u16,
    pub nMaxPage: u16,
    pub nCopies: u16,
    pub hInstance: *mut core::ffi::c_void,
    pub lCustData: isize,
    pub lpfnPrintHook: *mut core::ffi::c_void,
    pub lpfnSetupHook: *mut core::ffi::c_void,
    pub lpPrintTemplateName: *mut core::ffi::c_void,
    pub lpSetupTemplateName: *mut core::ffi::c_void,
    pub hPrintTemplate: *mut core::ffi::c_void,
    pub hSetupTemplate: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type PRINTDLGA struct {
	lStructSize uint32
	hwndOwner uintptr
	hDevMode uintptr
	hDevNames uintptr
	hDC uintptr
	Flags uint32
	nFromPage uint16
	nToPage uint16
	nMinPage uint16
	nMaxPage uint16
	nCopies uint16
	hInstance uintptr
	lCustData uintptr
	lpfnPrintHook uintptr
	lpfnSetupHook uintptr
	lpPrintTemplateName uintptr
	lpSetupTemplateName uintptr
	hPrintTemplate uintptr
	hSetupTemplate uintptr
}
type
  PRINTDLGA = packed record
    lStructSize: DWORD;
    hwndOwner: Pointer;
    hDevMode: Pointer;
    hDevNames: Pointer;
    hDC: Pointer;
    Flags: DWORD;
    nFromPage: Word;
    nToPage: Word;
    nMinPage: Word;
    nMaxPage: Word;
    nCopies: Word;
    hInstance: Pointer;
    lCustData: NativeInt;
    lpfnPrintHook: Pointer;
    lpfnSetupHook: Pointer;
    lpPrintTemplateName: Pointer;
    lpSetupTemplateName: Pointer;
    hPrintTemplate: Pointer;
    hSetupTemplate: Pointer;
  end;
const PRINTDLGA = extern struct {
    lStructSize: u32,
    hwndOwner: ?*anyopaque,
    hDevMode: ?*anyopaque,
    hDevNames: ?*anyopaque,
    hDC: ?*anyopaque,
    Flags: u32,
    nFromPage: u16,
    nToPage: u16,
    nMinPage: u16,
    nMaxPage: u16,
    nCopies: u16,
    hInstance: ?*anyopaque,
    lCustData: isize,
    lpfnPrintHook: ?*anyopaque,
    lpfnSetupHook: ?*anyopaque,
    lpPrintTemplateName: ?*anyopaque,
    lpSetupTemplateName: ?*anyopaque,
    hPrintTemplate: ?*anyopaque,
    hSetupTemplate: ?*anyopaque,
};
type
  PRINTDLGA {.packed.} = object
    lStructSize: uint32
    hwndOwner: pointer
    hDevMode: pointer
    hDevNames: pointer
    hDC: pointer
    Flags: uint32
    nFromPage: uint16
    nToPage: uint16
    nMinPage: uint16
    nMaxPage: uint16
    nCopies: uint16
    hInstance: pointer
    lCustData: int
    lpfnPrintHook: pointer
    lpfnSetupHook: pointer
    lpPrintTemplateName: pointer
    lpSetupTemplateName: pointer
    hPrintTemplate: pointer
    hSetupTemplate: pointer
align(1)
struct PRINTDLGA
{
    uint lStructSize;
    void* hwndOwner;
    void* hDevMode;
    void* hDevNames;
    void* hDC;
    uint Flags;
    ushort nFromPage;
    ushort nToPage;
    ushort nMinPage;
    ushort nMaxPage;
    ushort nCopies;
    void* hInstance;
    ptrdiff_t lCustData;
    void* lpfnPrintHook;
    void* lpfnSetupHook;
    void* lpPrintTemplateName;
    void* lpSetupTemplateName;
    void* hPrintTemplate;
    void* hSetupTemplate;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PRINTDLGA サイズ: 66 バイト(x86)
dim st, 17    ; 4byte整数×17(構造体サイズ 66 / 4 切り上げ)
; lStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hwndOwner : HWND (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hDevMode : HGLOBAL (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; hDevNames : HGLOBAL (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; hDC : HDC (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Flags : PRINTDLGEX_FLAGS (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; nFromPage : WORD (+24, 2byte)  wpoke st,24,値  /  値 = wpeek(st,24)
; nToPage : WORD (+26, 2byte)  wpoke st,26,値  /  値 = wpeek(st,26)
; nMinPage : WORD (+28, 2byte)  wpoke st,28,値  /  値 = wpeek(st,28)
; nMaxPage : WORD (+30, 2byte)  wpoke st,30,値  /  値 = wpeek(st,30)
; nCopies : WORD (+32, 2byte)  wpoke st,32,値  /  値 = wpeek(st,32)
; hInstance : HINSTANCE (+34, 4byte)  lpoke st,34,値  /  値 = lpeek(st,34)
; lCustData : LPARAM (+38, 4byte)  lpoke st,38,値  /  値 = lpeek(st,38)
; lpfnPrintHook : LPPRINTHOOKPROC (+42, 4byte)  lpoke st,42,値  /  値 = lpeek(st,42)
; lpfnSetupHook : LPSETUPHOOKPROC (+46, 4byte)  lpoke st,46,値  /  値 = lpeek(st,46)
; lpPrintTemplateName : LPSTR (+50, 4byte)  lpoke st,50,値  /  値 = lpeek(st,50)
; lpSetupTemplateName : LPSTR (+54, 4byte)  lpoke st,54,値  /  値 = lpeek(st,54)
; hPrintTemplate : HGLOBAL (+58, 4byte)  lpoke st,58,値  /  値 = lpeek(st,58)
; hSetupTemplate : HGLOBAL (+62, 4byte)  lpoke st,62,値  /  値 = lpeek(st,62)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PRINTDLGA サイズ: 114 バイト(x64)
dim st, 29    ; 4byte整数×29(構造体サイズ 114 / 4 切り上げ)
; lStructSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hwndOwner : HWND (+4, 8byte)  qpoke st,4,値 / qpeek(st,4)  ※IronHSPのみ。3.7/3.8は lpoke st,4,下位 : lpoke st,8,上位
; hDevMode : HGLOBAL (+12, 8byte)  qpoke st,12,値 / qpeek(st,12)  ※IronHSPのみ。3.7/3.8は lpoke st,12,下位 : lpoke st,16,上位
; hDevNames : HGLOBAL (+20, 8byte)  qpoke st,20,値 / qpeek(st,20)  ※IronHSPのみ。3.7/3.8は lpoke st,20,下位 : lpoke st,24,上位
; hDC : HDC (+28, 8byte)  qpoke st,28,値 / qpeek(st,28)  ※IronHSPのみ。3.7/3.8は lpoke st,28,下位 : lpoke st,32,上位
; Flags : PRINTDLGEX_FLAGS (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; nFromPage : WORD (+40, 2byte)  wpoke st,40,値  /  値 = wpeek(st,40)
; nToPage : WORD (+42, 2byte)  wpoke st,42,値  /  値 = wpeek(st,42)
; nMinPage : WORD (+44, 2byte)  wpoke st,44,値  /  値 = wpeek(st,44)
; nMaxPage : WORD (+46, 2byte)  wpoke st,46,値  /  値 = wpeek(st,46)
; nCopies : WORD (+48, 2byte)  wpoke st,48,値  /  値 = wpeek(st,48)
; hInstance : HINSTANCE (+50, 8byte)  qpoke st,50,値 / qpeek(st,50)  ※IronHSPのみ。3.7/3.8は lpoke st,50,下位 : lpoke st,54,上位
; lCustData : LPARAM (+58, 8byte)  qpoke st,58,値 / qpeek(st,58)  ※IronHSPのみ。3.7/3.8は lpoke st,58,下位 : lpoke st,62,上位
; lpfnPrintHook : LPPRINTHOOKPROC (+66, 8byte)  qpoke st,66,値 / qpeek(st,66)  ※IronHSPのみ。3.7/3.8は lpoke st,66,下位 : lpoke st,70,上位
; lpfnSetupHook : LPSETUPHOOKPROC (+74, 8byte)  qpoke st,74,値 / qpeek(st,74)  ※IronHSPのみ。3.7/3.8は lpoke st,74,下位 : lpoke st,78,上位
; lpPrintTemplateName : LPSTR (+82, 8byte)  qpoke st,82,値 / qpeek(st,82)  ※IronHSPのみ。3.7/3.8は lpoke st,82,下位 : lpoke st,86,上位
; lpSetupTemplateName : LPSTR (+90, 8byte)  qpoke st,90,値 / qpeek(st,90)  ※IronHSPのみ。3.7/3.8は lpoke st,90,下位 : lpoke st,94,上位
; hPrintTemplate : HGLOBAL (+98, 8byte)  qpoke st,98,値 / qpeek(st,98)  ※IronHSPのみ。3.7/3.8は lpoke st,98,下位 : lpoke st,102,上位
; hSetupTemplate : HGLOBAL (+106, 8byte)  qpoke st,106,値 / qpeek(st,106)  ※IronHSPのみ。3.7/3.8は lpoke st,106,下位 : lpoke st,110,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PRINTDLGA, pack=1
    #field int lStructSize
    #field intptr hwndOwner
    #field intptr hDevMode
    #field intptr hDevNames
    #field intptr hDC
    #field int Flags
    #field short nFromPage
    #field short nToPage
    #field short nMinPage
    #field short nMaxPage
    #field short nCopies
    #field intptr hInstance
    #field intptr lCustData
    #field intptr lpfnPrintHook
    #field intptr lpfnSetupHook
    #field intptr lpPrintTemplateName
    #field intptr lpSetupTemplateName
    #field intptr hPrintTemplate
    #field intptr hSetupTemplate
#endstruct

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