Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 9 - Printing Manager / Printing Manager Reference

Data Structures /

TPrDlg

The TPrDlg record contains information necessary when altering the default style or job dialog box for the current printer driver. The PrStlInit function (described on page 9-61) returns a TPrDlg record with information for a style dialog box; the PrJobInit function (described on page 9-62) returns a TPrDlg record with information for a job dialog box.

TYPE 
TPPrDlg  = TPrDlg;
TPrDlg   =                          {print dialog box record}
   RECORD
      Dlg:        DialogRecord;     {a dialog record}
      pFltrProc:                    {pointer to event filter}
                  ModalFilterProcPtr;
      pItemProc:  PItemProcPtr;     {pointer to item-handling }
                                    { procedure}
      hPrintUsr:  THPrint;          {handle to a TPrint record}
      fDoIt:      Boolean;          {TRUE means user clicked OK}
      fDone:      Boolean;          {TRUE means user clicked }
                                    { OK or Cancel}
      lUser1:     LongInt;          {storage for your application}
      lUser2:     LongInt;          {storage for your application}
      lUser3:     LongInt;          {storage for your application}
      lUser4:     LongInt;          {storage for your application}
   END;

Field Description

Dlg

A dialog record that represents either the style or job dialog box. This record is described in the chapter "Dialog Manager" in Inside Macintosh: Macintosh Toolbox Essentials.

pFltrProc

A pointer to an event filter function that handles events the Dialog Manager does not respond to (such as disk-inserted events and update events for background applications) in a modal dialog box. Event filter functions for modal dialog boxes are described in the chapter "Dialog Manager" in Inside Macintosh: Macintosh Toolbox Essentials.

pItemProc

A pointer to a routine (sometimes called a dialog hook) that responds to events in those items--such as checkboxes and radio buttons--that your application has added to the dialog box. See the chapter "Dialog Manager" in Inside Macintosh: Macintosh Toolbox Essentials for information about responding to events in dialog boxes.

hPrintUsr

A handle to a TPrint record (described on page 9-41) for a document.

fDoIt

A Boolean value indicating whether the user has confirmed the dialog box. A value of TRUE means the user has confirmed it by clicking the OK button.

fDone

A Boolean value indicating whether the user's interaction is completed. A value of TRUE means the user has clicked either the OK or Cancel button.

lUser1

In this field and the following fields, your application can store any kind of data you wish for the dialog box.

lUser2

Available for your application's use.

lUser3

Available for your application's use.

lUser4

Available for your application's use.

Figure 9-3 on page 9-6 shows a style dialog box. Figure 9-5 on page 9-7 shows a job dialog box. You can find information on how to customize a dialog box in "Altering the Style or Job Dialog Box" beginning on page 9-32.