编程开发技术――API教程之十二

编程开发技术――API教程之十二
2011年05月28日
　　函数功能：该挂钩函数是一个由应用程序或库定义的回调函数，该回调函数与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；库文件：用户自定义。
　　函数功能：该函数创建一个PageSetup对话框，此对话框能使用户指定打印页的属性。这些属性包括纸张大小和来源，送纸方向和页边距。
　　函数原型：BOOL PageSetupDlg（LPPAGESETUPDLGI ppsd）；
　　参数：
　　Ippsd：指向一个包含初始化对话框信息的PAGESETUPDLG结构。当函数返回时，该结构存放有关用户选择的信息。
　　返回值：如果用户点击OK钮，返回值为非零值，Ippsp参数指向的PAGESETUPDLG结构中的成员显示用户的选择。如果用户取消或关闭PageSetup对话框或错误出现，返回值为零。若想获得更多的错误信息，请调用CommDlgExtendedError函数
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：commdlg.h；库文件：commdlg32.lib；Unicode：在Windows NT环境中实现为Unicode和ANSI两个版本。
　　函数功能：该挂钩函数为由应用程序或库定义的回调函数。此回调函数与PageSetupDlg函数一起使用，它接收为PageSetup公用对话框设置缺省对话框的消息或通告。LPPAGESETUPHOOK类型定义了一个指向此回调函数的指针。PageSetupHook是由应用程序或库定义的函数名的位置持有者。
　　函数原型：UINT CALLBACK PageSetupHook（HWND hdlg，UINT uiMsg，WPARAM wParam，LPARAM IParam）；
　　参数：
　　hdlg：指向消息指定给Page Setup对话框窗口的句柄。
　　uiMsg：标识接收的消息。
　　wParam：指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。
　　IParam：指定有关消息的其他信息。精确的意义要根据uiMsg参数的值来决定。
　　返回值：如果挂钩函数返回零，则缺省对话框函数处理消息；返回非零值，将忽略消息。
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：commdlg.h；库文件：用户自定义。
　　函数功能：该函数显示打印对话框或打印设置对话框。打印对话框使用户指定特殊的打印工作的特点。
　　打印设置对话框不能应用在新应用程序中，它已经被PageSetupDlg函数创建的打印设置公共对话框所替代。
　　函数原型：BOOL PrintDIg（LPPRINTDLG Ippd）；
　　参数：
　　Ippd：指向一个含有初始化对话框信息的PRINTDLG结构。当PRINTDLG函数返回时，此结构含有关用户选择的信息。
　　返回值：如果用户点击OK按钮，返回值为非零值。由lppd参数指向的PRINTDLG结构中的成员显示用户的选择。如果用户取消或关闭Print或PrinterSetup对话框或错误出现，返回值为零。若想获得更多的错误信息，请调用CommDlgError函数。如果用户取消或关闭对话框，函数返回零值：否则，返回值如下：
　　CDERR_FINDRESFAILURE PDERR_CRETELCFAILUPE
　　COERR_INITIALIZATION PDERR_DEFAULTDIFFERENT
　　CDERR_LOADRESFAILURE PDERR_DNDMMISMATCH
　　CDERR_LOADSTRFAILURE PDERR_GETDEVMODEFAIL
　　CKERR_LOCKRESFAILURE PDERR_INITFAILURE
　　CDERR_MEMALLOCFAILURE PDERR LOADDRVFAILURE
　　CDERR_MEMLOCKFAILURE PDERR_NODEFAULTPRN
　　CDERR_NOHINSTANCE PDERR_NODEVICES
　　CDFRR_NOHOOK PDERR_PARSEFAILURE
　　CDERR_NOTEMPLATE PDERR_PRINTERNOTFOUND
　　CDERR_STRUCTSIZE PDERR_RETDEFFAILURE
　　备注：如果挂钩函数（由PRINTDLG结构中的IpfnrintHOOk成员或IpfnSetupHOOk成员指向的）处理WM_CTLCOLORDLG信息，挂钩函数必须返回一个刷子句柄，此刷了用来刷控制背景。
　　Windows NT 5.0以及以后的版本：可用PrintDlgEx函数来显示一个Print属性页，此属性页有一个含有Print公共对话框相似的控制的General页，其控制与Print公共对话框中的控制相似。
　　Windows CE：PRINTDLG结构包含Windows CE中不同的成员。
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；头文件：commdlg.h；库文件：comdlg32.lih；Unicode：在Windows NT环境中实现为Unicode和ANSI两个版本。
　　函数功能：该函数显示打印对话框或打印设置对话框。打印对话框使用户指定特殊的打印工作的特点。
　　打印设置对话框不能应用在新应用程序中，它已经被PageSetupDlg函数创建的打印设置公共对话框所替代。
　　函数原型：BOOL PrintDIg（LPPRINTDLG Ippd）；
　　参数：
　　Ippd：指向一个含有初始化对话框信息的PRINTDLG结构。当PRINTDLG函数返回时，此结构含有关用户选择的信息。
　　返回值：如果用户点击OK按钮，返回值为非零值。由lppd参数指向的PRINTDLG结构中的成员显示用户的选择。如果用户取消或关闭Print或PrinterSetup对话框或错误出现，返回值为零。若想获得更多的错误信息，请调用CommDlgError函数。如果用户取消或关闭对话框，函数返回零值：否则，返回值如下：
　　CDERR_FINDRESFAILURE PDERR_CRETELCFAILUPE
　　COERR_INITIALIZATION PDERR_DEFAULTDIFFERENT
　　CDERR_LOADRESFAILURE PDERR_DNDMMISMATCH
　　CDERR_LOADSTRFAILURE PDERR_GETDEVMODEFAIL
　　CKERR_LOCKRESFAILURE PDERR_INITFAILURE
　　CDERR_MEMALLOCFAILURE PDERR LOADDRVFAILURE
　　CDERR_MEMLOCKFAILURE PDERR_NODEFAULTPRN
　　CDERR_NOHINSTANCE PDERR_NODEVICES
　　CDFRR_NOHOOK PDERR_PARSEFAILURE
　　CDERR_NOTEMPLATE PDERR_PRINTERNOTFOUND
　　CDERR_STRUCTSIZE PDERR_RETDEFFAILURE
　　备注：如果挂钩函数（由PRINTDLG结构中的IpfnrintHOOk成员或IpfnSetupHOOk成员指向的）处理WM_CTLCOLORDLG信息，挂钩函数必须返回一个刷子句柄，此刷了用来刷控制背景。
　　Windows NT 5.0以及以后的版本：可用PrintDlgEx函数来显示一个Print属性页，此属性页有一个含有Print公共对话框相似的控制的General页，其控制与Print公共对话框中的控制相似。
　　Windows CE：PRINTDLG结构包含Windows CE中不同的成员。
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；头文件：commdlg.h；库文件：comdlg32.lih；Unicode：在Windows NT环境中实现为Unicode和ANSI两个版本。
　　函数功能：该函数显示一个Print属性页。该属性页使用户指定特定的打印工作的特性，一个Print属性页有一个控制的General页。该控制与Print中的对话框相似。属性页也有另外紧随General页的指定的应用程序和指定的驱动器特性页。
　　函数原型：HRESULT PrintDlgEx（LPPRINTDLGEX Ippd）；
　　参数：
　　Ippd：指向一个包括初始化属性页信息的PRINTDLGEX结构。当PrintDlgEx函数返回时，此结构含有关于用户选择的信息。
　　返回值：如果函数调用成功，返回值为S_OK，且PRINTDLGEX结构中的dw ResuhltAction成员含有下列值：
　　PD_RESULT_APPLY：用户点击Apply按钮，然后点击Cancel按钮，这显示出用户想应用在属性页中做的改变，但还不想打印。当Apply按钮被点击时，PRINTDLGEX结构包含用户指定的信息。
　　PD_RESUCT_CANCEI：用户点击Cancel按钮，PRINTDLGEX结构中的信息未被改变。
　　PD_RESUCT_PRINT：用户点击Print按钮，PRINTDLGEX结构含有用户指定的信息。
　　如果函数调用成功，返回值可能是下列COM错误代码中的一个，有关更多的信息请参见ErrorHandling。
　　E_OUTOFMEMORT：内存不足；E_INVALIDARG：一个或更多的参数无效。
　　E_POINTER：指针失效；E_HANDLE：句柄失效；E_FAIL：不确定的错误。
　　备注：有关更多的信息，请见Print Propertysheet。
　　速查：Windows NT：5.0及以上版本；Windowss：不支持；Windows CE：不支持；头文件：commdlg.h，库文件。comdlg32.lib；Unicode：在Windows NT环境中实现为Unicode和ANSI两个版本。
　　函数功能：该挂钩函数是一个由应用程序或库定义的回调函数，此回调函数与PrintDlg函数一起使用。
　　函数接收指定给Print公共对话框的缺省对话框函数的消息和通知。LPPWTHOOKPROC类型定义了一个指向此回调函数的指针。PrintHookProc为由应用程序或库定义的函数名的位置占有者。
　　函数原型：UINT CALLBACK PrintHookProc（HWND hdlg，UINT uiMsg，WPARAM wParam，LPARAM IParam）；
　　参数：
　　hdlg：指向消息指定给的Print公共对话框窗口的句柄。
　　uiMsg：标识接收的消息。
　　wParam：指定有关消息的其他信息、精确的意义由uiMsg参数的值来决定。
　　IParam：指定有关消息的其他信息、精确的意义由uiMsg参数的值来决定。
　　返回值：如果挂钩函数返回值为零，缺省对话框函数处理消息；返回非零值，将忽略消息。
　　备注：当用PrintDlg函数创建一个Print公共对话框时，可以提供一个PrintHookProc挂钩函数来处理指定给对话框函数的消息或通知。
　　为使挂钩函数生效，要用传递到创建对话框函数的PRINTDLG结构，且要指定IpfnPrintHook成员中挂钩函数的地址和指定Flags成员中PD_ENABLEPRINTHOOK标志。
　　缺省对话框函数把消息WM_InITDIALOG传送到挂钩函数之前先处理此消息。对于其他所有的消息，挂钩函数首先存放消息。然后其返回值决定此缺省对话函数是处理消息或忽略消息。
　　速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；头文件：commdlg.h；库文件：用户自定义。