LPPAGEPAINTHOOK 回调函数 (commdlg.h)

接收允许您在“ 页面设置 ”对话框中自定义示例页面绘图的消息。 PagePaintHook 挂钩过程是应用程序定义的或库定义的回调函数，与 PageSetupDlg 函数一起使用。

LPPAGEPAINTHOOK 类型定义指向此回调函数的指针。 PagePaintHook 是应用程序定义的或库定义的函数名称的占位符。

语法

LPPAGEPAINTHOOK Lppagepainthook;

UINT_PTR Lppagepainthook(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

参数

unnamedParam1

“页面设置”对话框的句柄。

unnamedParam2

接收的消息的标识符。

unnamedParam3

关于消息的附加信息。 确切的含义取决于 unnamedParam2 参数的值。

unnamedParam4

关于消息的附加信息。 确切的含义取决于 unnamedParam2 参数的值。

返回值

如果挂钩过程为绘图序列的前三条消息 (WM_PSD_PAGESETUPDLG、WM_PSD_FULLPAGERECT或WM_PSD_MINMARGINRECT) 返回 TRUE，则对话框不会发送更多消息，并且直到系统下次需要重新绘制示例页时，才会在示例页中绘制。 如果挂钩过程对所有三条消息返回 FALSE ，则对话框将发送绘图序列的剩余消息。

如果挂钩过程对绘图序列中剩余的任何消息返回 TRUE ，则对话框不会绘制示例页的相应部分。 如果挂钩过程为其中任何消息返回 FALSE ，则对话框将绘制示例页的该部分。

注解

“ 页面设置 ”对话框包含示例页面的图像，该图像显示用户选择如何影响打印输出的外观。 图像由表示所选纸张或信封类型的矩形组成，虚线矩形表示当前边距，部分 (希腊文文本) 字符，以显示文本在打印页上的外观。 使用 PageSetupDlg 函数创建 页面设置 对话框时，可以提供 PagePaintHook 挂钩过程来自定义示例页面的外观。

若要启用挂钩过程，请使用传递给创建函数的 PAGESETUPDLG 结构。 指定指向 lpfnPagePaintHook 成员中的挂钩过程的指针，并在 Flags 成员中指定PSD_ENABLEPAGEPAINTHOOK标志。

每当对话框即将绘制示例页的内容时，挂钩过程将按消息的列出顺序接收以下消息。

消息	含义
WM_PSD_PAGESETUPDLG	对话框将绘制示例页。 挂钩过程可以使用此消息来准备绘制示例页面的内容。
WM_PSD_FULLPAGERECT	对话框将绘制示例页。 此消息指定示例页的边框。
WM_PSD_MINMARGINRECT	对话框将绘制示例页。 此消息指定边距矩形。
WM_PSD_MARGINRECT	对话框将绘制边距矩形。
WM_PSD_GREEKTEXTRECT	对话框即将在边距矩形内绘制希腊文文本。
WM_PSD_ENVSTAMPRECT	对话框即将在信封示例页的信封标记矩形中绘制。 此消息仅针对信封发送。
WM_PSD_YAFULLPAGERECT	对话框将绘制信封示例页的回信地址部分。 此消息针对信封和其他纸张大小发送。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	commdlg.h (包括 Windows.h)

另请参阅

通用对话框库

概念性

PAGESETUPDLG

PageSetupDlg

引用