Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Imaging With QuickDraw /
Chapter 9 - Printing Manager / Printing Manager Reference
Printing Manager Routines / Displaying and Customizing the Print Dialog Boxes


You can use the PrJobDialog function to display the job dialog box provided by the resource file for the current printer driver.

FUNCTION PrJobDialog (hPrint: THPrint): Boolean;
A handle to a TPrint record (described on page 9-41), which may be a new record or an existing one from a document.
The PrJobDialog function gets the initial settings to display in the job dialog box from the TPrint record specified in the hPrint parameter. The user specifies the print quality, the range of pages to print, and other information in the job dialog box. Your application should display this dialog box when the user chooses Print from the File menu.

If the user confirms the dialog box, the PrJobDialog function updates both the TPrint record and the printer driver resource file and calls the PrValidate function, and the PrJobDialog function returns TRUE. Even if the function returns FALSE, the PrJobDialog function may have updated the TPrint record.

You should proceed with the requested printing operation only if the PrJobDialog function returns TRUE. You should never call PrJobDialog between the pages of a document.

The trap macro and routine selector for the PrJobDialog function are
Trap macroSelector

See Figure 9-5 on page 9-7 for an example of a job dialog box. For more information on the use of a job dialog box, see "Getting Printing Preferences From the User" beginning on page 9-5. For information on how to customize a job dialog box, see "Altering the Style or Job Dialog Box" beginning on page 9-32.

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996