Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 9 - Printing Manager / Printing Manager Reference

Printing Manager Routines / Displaying and Customizing the Print Dialog Boxes

PrStlDialog

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

FUNCTION PrStlDialog (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 PrStlDialog function gets the initial settings to display in the style dialog box from the TPrint record specified in the hPrint parameter. The user specifies the page dimensions and other information needed for page setup through the style dialog box. Your application should display this dialog box when the user chooses Page Setup from the File menu.

If the user confirms the dialog box, the PrStlDialog function returns TRUE. The PrStlDialog function saves the results of the dialog box in the specified TPrint record and calls the PrValidate function (described on page 9-57). Otherwise, the TPrint record is left unchanged and the function returns FALSE.

SPECIAL CONSIDERATIONS

You should never call PrStlDialog between the pages of a document.

You must call the PrOpen procedure (described on page 9-54) prior to calling PrStlDialog, and you must call the PrClose procedure (described on page 9-55) afterward, because the current printer driver must be open in order for your application to successfully call PrStlDialog.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the PrStlDialog function are

Trap macro	Selector
_PrGlue	$2A040484

SEE ALSO

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