PrDlgMain

PrDlgMain Initialize for and execute a print dialog

#include <PrintTraps.h> Printing Manager

Boolean PrDlgMain(hPrtRec, pDlgInit );

THPrint hPrtRec ; handle leading to a TPrint structure

ProcPtr pDlgInit ; address of a dialog initialization routine

returns Was the dialog OKed?

PrDlgMain is called automatically by PrJobDialog and PrStlDialog.

Applications may call it to modify the standard print dialogs.

hPrtRec is a handle leading to a 120-byte TPrint structure, as previously

prepared by a call to PrintDefault or PrValidate.

pDlgInit is the address of a special dialog initialization routine. When called

by the Print Manager (i.e., in the normal course of events), this

value is the address of the code handling PrJobInit or PrStlInit.

Returns: a Boolean; it indicates whether the user has approved the contents of

hPrtRec as reflected in the dialog. It is one of:

FALSE The user selected Cancel; no fields were changed.

TRUE The user selected OK and the print record is valid.

Notes: PrDlgMain is documented in Technical Note #95, which describes a

technique with which you can add items to the standard "Print..." and "Page

Setup..." dialogs. See Adding Items to the Print Dialogs for more information.

PrDlgMain calls pDlgInit to setup a TPrDlg structure, then displays the

dialog obtained thereby and calls ModalDialog.

See PrJobInit, PrStlInit, and TPrDlg for related information

Referenced by (11):