|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| comdlg32.lib
| Header File
| commdlg.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
PrintDlg
The PrintDlg function displays a Print dialog box or a Print Setup dialog box. The Print
dialog box enables the user to specify the properties of a particular print job.
The Print Setup dialog box should not be used in new applications. It has been
superseded by the Page Setup common dialog box created by the PageSetupDlg function.
BOOL PrintDlg(
LPPRINTDLG lppd
| // address of structure with initialization data
| );
|
|
Parameters
lppd
Pointer to a PRINTDLG structure that contains information used to initialize the dialog box. When PrintDlg returns, this structure contains information about the user's selections.
Return Values
If the user clicks the OK button, the return value is nonzero. The members of
the PRINTDLGstructure pointed to by the lppd parameter indicate the user's selections.
If the user cancels or closes the Print or Printer Setup dialog box or an error occurs, the return value is zero. To get extended
error information, use the CommDlgExtendedError function, which can return one of the following values:
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
|
Remarks
If the hook procedure (pointed to by the lpfnPrintHook or lpfnSetupHook member of the PRINTDLG structure) processes the WM_CTLCOLORDLG message, the hook procedure must
return a handle for the brush that should be used to paint the control background.
See Also
CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
