ฟังก์ชันPrintDlgแสดงในกล่องโต้ตอบการพิมพ์หรือกล่องโต้ตอบการตั้งค่าการพิมพ์ กล่องโต้ตอบพิมพ์ช่วยให้ผู้ใช้ระบุคุณสมบัติของงานพิมพ์โดยเฉพาะ .
กล่องโต้ตอบการตั้งค่าการพิมพ์ไม่ควรใช้ในแอปพลิเคชันใหม่ มันได้ถูกแทนที่ โดยหน้าการตั้งค่าทั่วไปกล่องโต้ตอบสร้าง โดยฟังก์ชันPageSetupDlg .
(BOOL PrintDlg LPPRINTDLG lppd / / ชี้ไปยังโครงสร้างด้วยการเตรียมใช้งานข้อมูล);
หากผู้ใช้คลิกปุ่มตกลงค่าส่งกลับจะไม่ใช่ศูนย์ สมาชิกของโครงสร้างPRINTDLGชี้ส่อ โดยพารามิเตอร์lppdของผู้ใช้ที่เลือก.
ถ้าผู้ใช้ยกเลิก หรือปิดกล่องโต้ตอบการพิมพ์หรือการตั้งค่าเครื่องพิมพ์หรือมีข้อผิดพลาดเกิดขึ้น ค่าส่งกลับเป็นศูนย์ การรับข้อมูลความผิดพลาดแบบขยาย ใช้ฟังก์ชันCommDlgExtendedError ถ้าผู้ใช้ยกเลิก หรือปิดกล่องโต้ตอบ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 |
ถ้าขั้นตอนของ hook (ชี้ไป โดยสมาชิกlpfnPrintHookหรือlpfnSetupHookของโครงสร้างPRINTDLG ) ประมวลผลข้อความ WM_CTLCOLORDLG ขั้นตอนของ hook ต้องส่งกลับจับสำหรับการแปรงที่ควรใช้ในการระบายสีพื้นหลังของตัวควบคุม.
Windows NT 5.0 และรุ่นใหม่กว่า: คุณสามารถใช้ฟังก์ชันPrintDlgExเพื่อแสดงแผ่นคุณสมบัติในการพิมพ์ซึ่งมีหน้าทั่วไปประกอบด้วยตัวควบคุมที่คล้ายคลึงกับกล่องโต้ตอบพิมพ์ทั่วไป.
Windows CE: โครงสร้างของPRINTDLGประกอบด้วยสมาชิกอื่นใน Windows CE ไม่เหมือนในสถาปัตยกรรมเดสก์ทอป Windows.
nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการรุ่น 2.0 หรือใหม่กว่า
หัวข้อ:ประกาศใน commdlg.h
ไลบรารีที่นำเข้า:ใช้ comdlg32.lib
Unicode:นำมาใช้เป็น Unicode และ ANSI รุ่นบน Windows NT.
ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปฟังก์ชันของกล่องโต้ตอบทั่วไป CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG