函式功能
該函式顯示列印對話框或列印設定對話框。列印對話框使用戶指定特殊的列印工作的特點。
列印設定對話框不能套用在新應用程式中,它已經被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兩個版本。