一个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挂接过程的指针。
也可以看看