הפונקציה 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, ההליך הוו חייב להחזיר נקודת אחיזה המברשת בהם יש להשתמש כדי לצבוע את הרקע של פקד.
Windows NT 5.0 ואילך: באפשרותך להשתמש בפונקציה PrintDlgEx כדי להציג להדפיס גליון המאפיינים, ובו דף כללי המכיל פקדים דומה אל תיבת הדו-שיח הדפסה נפוצות.
חלונות CE: המבנה PRINTDLG מכיל חברים שונים ב- Windows CE מאשר בפלטפורמות בשולחן העבודה של Windows.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:מחייב גירסה 2.0 או גירסה מתקדמת יותר.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:השתמש comdlg32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.
סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות בתיבת הדו-שיח, CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG