PAGESETUPDLG

PAGESETUPDLG结构包含PageSetupDlg函数用于初始化“页面设置”公共对话框的信息。在用户关闭对话框后，系统将在此结构中返回有关用户定义的页面参数的信息。

typedef struct tagPSD { A set of bit flags that you can use to initialize the Page Setup common dialog box.

DWORD lStructSize;

HWND hwndOwner;

HGLOBAL hDevMode;

HGLOBAL hDevNames;

DWORD Flags;

POINT ptPaperSize;

RECT rtMinMargin;

RECT rtMargin;

HINSTANCE hInstance;

LPARAM lCustData;

LPPAGESETUPHOOK lpfnPageSetupHook;

LPPAGEPAINTHOOK lpfnPagePaintHook;

LPCTSTR lpPageSetupTemplateName;

HGLOBAL hPageSetupTemplate;

} PAGESETUPDLG, * LPPAGESETUPDLG;

会员

lStructSize

指定此结构的大小（以字节为单位）。

hwndOwner

标识拥有该对话框的窗口。该成员可以是任何有效的窗口句柄，如果对话框没有所有者，它可以为NULL。

hDevMode

处理包含DEVMODE结构的全局内存对象。在输入时，如果给出句柄，则使用相应DEVMODE结构中的值初始化对话框中的控件。在输出时，对话框将hDevMode设置为DEVMODE结构的全局内存句柄，其中包含指定用户选择的值。如果用户的选择不可用，则对话框将hDevMode设置为NULL。

hDevNames

处理包含DEVNAMES结构的全局内存对象。此结构包含三个指定驱动程序名称，打印机名称和输出端口名称的字符串。在输入时，如果给出句柄，则相应的DEVNAMES结构中的字符串用于初始化对话框中的控件。在输出时，对话框将hDevNames设置为包含指定用户选择的字符串的DEVNAMES结构的全局内存句柄。如果用户的选择不可用，则对话框将hDevNames设置为NULL。

旗

一组位标志，可用于初始化“页面设置”公共对话框。当对话框返回时，它设置这些标志以指示用户的输入。该成员可以是以下标志的组合：

ptPaperSize

指定用户选择的纸张的尺寸。PSD_INTHOUSANDTHSOFINCHES或PSD_INHUNDREDTHSOFMILLIMETERS标志表示测量单位。

rtMinMargin

指定左，上，右和下边距的最小允许宽度。如果未设置PSD_MINMARGINS标志，系统将忽略此成员。这些值必须小于或等于rtMargin成员中指定的值。PSD_INTHOUSANDTHSOFINCHES或PSD_INHUNDREDTHSOFMILLIMETERS标志表示测量单位。

rtMargin

指定左，上，右和下边距的宽度。如果设置PSD_MARGINS标志，rtMargin指定初始保证金值。当PageSetupDlg返回时，rtMargin包含用户选择的边距宽度。PSD_INHUNDREDTHSOFMILLIMETERS或PSD_INTHOUSANDTHSOFINCHES标志表示测量单位。

的hInstance

如果在旗成员中设置了PSD_ENABLEPAGESETUPTEMPLATE标志，则的hInstance是包含由lpPageSetupTemplateName成员命名的对话框模板的应用程序或模块实例的句柄。

lCustData

指定系统传递给由lpfnPageSetupHook成员标识的挂接过程的应用程序定义数据。当系统向挂接过程发送WM_INITDIALOG消息时，消息的【lParam的】参数是指向创建对话框时指定的PAGESETUPDLG结构的指针。挂钩过程可以使用此指针获取lCustData值。

lpfnPageSetupHook

指向PageSetupHook挂接过程的指针，可以处理针对该对话框的消息。除非在旗成员中设置了PSD_ENABLEPAGESETUPHOOK标志，否则此成员将被忽略。

lpfnPagePaintHook

指向PagePaintHook挂钩过程的指针，每当重新绘制示例页面时，都会从对话框接收WM_PSD_ *消息。通过处理消息，挂钩过程可以自定义样本页面的外观。除非在旗成员中设置了PSD_ENABLEPAGEPAINTHOOK标志，否则此成员将被忽略。

lpPageSetupTemplateName

指向由的hInstance成员标识的模块中的对话框模板资源的以null结尾的字符串的指针。此模板代替标准对话框模板。对于编号的对话框资源，lpPageSetupTemplateName可以是MAKEINTRESOURCE宏返回的值。除非在旗成员中设置了PSD_ENABLEPAGESETUPTEMPLATE标志，否则该成员将被忽略。

hPageSetupTemplate

如果在旗成员中设置了PSD_ENABLEPAGESETUPTEMPLATEHANDLE标志，则hPageSetupTemplate是包含对话框模板的内存对象的句柄。

备注

如果未指定PSD_INHUNDREDTHSOFMILLIMETERS和PSD_INTHOUSANDTHSOFINCHES标志，则系统将查询默认用户区域设置的LOCALE_IMEASURE值，以确定边距宽度和纸张尺寸的度量单位（百分之几或毫米）。

如果hDevNames和hDevMode都有有效的句柄，DEVNAMES结构的wDeviceOffset成员指定的打印机名称与DEVMODE结构的dmDeviceName??成员所指定的名称不同，系统默认使用wDeviceOffset指定的名称。

也可以看看

DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG