Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 9 - Printing Manager / Printing Manager Reference

Printing Manager Routines / Displaying and Customizing the Print Dialog Boxes

PrDlgMain

To display a customized style or job dialog box for the current printer driver, use the PrDlgMain function.

FUNCTION PrDlgMain (hPrint: THPrint; pDlgInit: PDlgInitProcPtr):
                   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.

pDlgInit

A pointer to your own initialization procedure or a pointer to one of the default initialization functions (PrStlInit, which is described in the next section, or PrJobInit, which is described on page 9-62).

DESCRIPTION

You use the PrDlgMain function to display a style or job dialog box that your application has altered. (If you use the standard style and job dialog boxes, you do not need to call PrDlgMain; instead, you can simply call the PrStlDialog or PrJobDialog function, described on page 9-58 and page 9-59, respectively.)

If you want to customize a style or job dialog box, first call PrStlInit, which is described in the next section, or PrJobInit, which is described on page 9-62, to get a pointer to the TPrDlg record (described on page 9-47) for that dialog box. The PrStlInit function returns a pointer to the TPrDlg record for the style dialog box of the current printer driver; the PrJobInit function returns a pointer to the TPrDlg record of the job dialog box for the current printer driver. You should supply the TPrDlg record for your customized dialog box with a function that handles events that the Dialog Manager doesn't handle, and with another function that handles events in the items you add to the dialog box.

When PrDlgMain returns TRUE, you should proceed with the requested printing operation.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the PrDlgMain function are

Trap macro	Selector
_PrGlue	$4A040894

SEE ALSO

For more information about customizing style or job dialog boxes, see "Altering the Style or Job Dialog Box" beginning on page 9-32.