Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 9 - Printing Manager / Printing Manager Reference

Printing Manager Routines / Displaying and Customizing the Print Dialog Boxes

PrJobDialog

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;

hPrint

A handle to a TPrint record (described on page 9-41), which may be a new record or an existing one from a document.

DESCRIPTION

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.

SPECIAL CONSIDERATIONS

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.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the PrJobDialog function are

Trap macro	Selector
_PrGlue	$32040488

SEE ALSO

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.