Important: The information in this document is obsolete and should not be used for new development.
TPrDlg
TheTPrDlg
record contains information necessary when altering the default style or job dialog box for the current printer driver. ThePrStlInit
function (described on page 9-61) returns aTPrDlg
record with information for a style dialog box; thePrJobInit
function (described on page 9-62) returns aTPrDlg
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;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.
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.