PrintDlg功能显示“打印”对话框或“打印设置”对话框。“打印”对话框使用户能够指定特定打印作业的属性。
“打印设置”对话框不应在新应用程序中使用。它已被PageSetupDlg功能创建的Page Setup常用对话框所取代。
BOOL PrintDlg(
| LPPRINTDLG 【LPPD】 | //具有初始化数据的结构地址 |
| ); |
参数
【LPPD】
指向PRINTDLG结构的指针,其中包含用于初始化对话框的信息。当PrintDlg返回时,此结构包含有关用户选择的信息。
返回值
如果用户单击确定按钮,则返回值不为零。【LPPD】参数指向的PRINTDLG结构的成员表示用户的选择。
如果用户取消或关闭打印或打印机设置对话框或发生错误,返回值为零。要获取扩展错误信息,请使用CommDlgExtendedError函数,该函数可以返回以下值之一:
| CDERR_FINDRESFAILURE | PDERR_CREATEICFAILURE |
| CDERR_INITIALIZATION | PDERR_DEFAULTDIFFERENT |
| CDERR_LOADRESFAILURE | PDERR_DNDMMISMATCH |
| CDERR_LOADSTRFAILURE | PDERR_GETDEVMODEFAIL |
| CDERR_LOCKRESFAILURE | PDERR_INITFAILURE |
| CDERR_MEMALLOCFAILURE | PDERR_LOADDRVFAILURE |
| CDERR_MEMLOCKFAILURE | PDERR_NODEFAULTPRN |
| CDERR_NOHINSTANCE | PDERR_NODEVICES |
| CDERR_NOHOOK | PDERR_PARSEFAILURE |
| CDERR_NOTEMPLATE | PDERR_PRINTERNOTFOUND |
| CDERR_STRUCTSIZE | PDERR_RETDEFFAILURE |
备注
如果lpfnPrintHook或lpfnSetupHook PRINTDLG结构的lpfnSetupHook成员的挂钩过程处理WM_CTLCOLORDLG消息,挂钩过程必须返回应用于绘制控件背景的画笔的句柄。
也可以看看
CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG