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