PagePaintHook

【勇芳软件工作室】汉化HomePreviousNext

一个PagePaintHook挂接过程是与“页面设置”对话框一起使用的应用程序定义或库定义的回调过程。挂钩过程接收允许您在“页面设置”对话框中自定义样本页面的消息。

UINT APIENTRY PagePaintHook(en

HWND 【hdlg】,//对话框窗口的句柄
UINT 【uiMsg】,//消息标识符fr
WPARAM 【wParam中】,// message参数
LPARAM 【lParam的】// message参数
); 

参数

【hdlg】

处理页面设置对话框窗口。

【uiMsg】

标识正在接收的消息。

【wParam中】

指定有关该消息的附加信息。具体含义取决于【uiMsg】参数的值。

【lParam的】

指定有关该消息的附加信息。具体含义取决于【uiMsg】参数的值。

返回值

如果挂钩过程对于绘图序列(WM_PSD_PAGESETUPDLG,WM_PSD_FULLPAGERECT或WM_PSD_MINMARGINRECT)的前三个消息中的任何一个返回TRUE,对话框不会再发送消息,并且不会在示例页面中绘制,直到系统需要重绘示例页面。如果挂钩过程对所有三个消息返回FALSE,则对话框将发送绘图序列的其余消息。

如果挂钩过程对于绘图序列中的任何剩余消息返回TRUE,对话框不绘制示例页面的相应部分。如果挂钩过程返回任何这些消息的FALSE,该对话框将绘制示例页面的该部分。

备注

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

要启用挂钩过程,请使用传递给对话框创建功能的PAGESETUPDLG结构。在lpfnPagePaintHook成员中指定钩子过程的指针,并在成员中指定PSD_ENABLEPAGEPAINTHOOK标志。

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

Message含义
WM_PSD_PAGESETUPDLG该对话框即将绘制示例页面。挂钩过程可以使用此消息准备绘制示例页面的内容。
WM_PSD_FULLPAGERECT该对话框即将绘制示例页面。此消息指定样本页面的边界矩形。
WM_PSD_MINMARGINRECT该对话框即将绘制示例页面。此消息指定边距矩形。
WM_PSD_MARGINRECT该对话框即将绘制边距矩形。
WM_PSD_GREEKTEXTRECT该对话框即将在边框矩形内绘制希腊语文本。
WM_PSD_ENVSTAMPRECT对话框即将绘制信封样本页的信封字母矩形。此消息仅发送给信封。
WM_PSD_YAFULLPAGERECT对话框即将绘制信封样本页的返回地址部分。此信息是为信封和其他纸张尺寸发送的。

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

也可以看看

PageSetupDlg, PAGESETUPDLG