pagepainthook()函数

函数功能:该挂钩函数是一个由应用程序或库定义的回调函数,该回调函数与PageSetup函数一起使用。该函数接收制作PageSetup对话框中样本页绘图的消息。LLPPAGEPAINTHOOK类型定义了一个指向此回调函数的指针。PagePaintHook是由应用程序或库定义的函数名的位置持有者。

函数原型:UINT CALLBACK PagePaintHook(HWND hdlg,UINT uiMsg,WPARAM wParam,LPARAM IParam);

参数:

hdlg:指向pagesetup对话枢窗口的句柄。

uiMsg:标识接收的消息。

wparam:指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。

IParam:指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。

返回值:如果挂钩函数对前三个绘图顺序消息中的任何一个返回值为TRUE。且前三个消息为WM_PSD_PAGESETUPDLG,WM_PSD_FULLPAGERECT或WM_PSD_MINMARGINRECT),对话框不再发送消息。且直到下一次系统需要重画样本页时才绘出样本页。如果对所有的三个消息。挂钩函数返回FALSE,对话框发送给图顺序的保留的消息。

如果挂钩函数对绘图顺序中保留消息的任何一个,返回值为TRUE,那么对话框不绘样本页对应的部分,如果挂钩函数对这些信息中的任何一个返回值为FALSE,对话框绘样本页部分。

备注PageSetup对话框含有一个样本页的构想。此构想展示了用户选择如何影响打印输出的外观。构想由代表选择页或信封类型的长方形组成,点线长方形代表当前页边。部分字母展示了文本在打印出的页中的状况。当用PageSetupDlg函数创建Page Setup Dialog对话框时,可提供一个PagePaintHook挂钩函数来制作样本页的表观。

为使挂钩函数生效,须用传递到创建对话函数的PAGESETUPDLG结构,且指定一个指向

IpfnPagePrintHook成员中挂钩函数的指针和指定Flags成员中PSD_ENABLEPAGEPAINTHOOK标志。

无论何时,只要对话框将要绘样本页的内容,那么挂钩函数就接受以下列顺序列表的消息:WM_PSD_PAGESETUPDLG:对话框将要绘样本页,挂钩函数利用此消息准备给样本页里的内容。

WM_PSD_FULLPAGERECT:对话框要绘样本页,此信息指定样本页的长方形边。

WM_PSD_MINMARGINRECT:对话框将要绘样本页,此信息指定空白长方形。

WM_PSD_MARGINRECT:对话框将要绘空白长方形。

WM_PSD_REEKTEXTRECT:对话框将要在空白长方形内绘Greek文本。

WM_PSD_ENVSTAMPRECT:对话框将要在信封样本页上绘邮票长方形。此消息仅发向信封。

WM_PSD_YAFULLPAGERECT:对话框将要绘信封样本页的返回地址部分。此消息仅发向信封和其他纸张大小。

速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持:头文件:commdlg.h;库文件:用户自定义。