Carbon


PMSessionPrintDialogMain

Header: PMApplication.h Carbon status: Supported

Displays your application’s custom Print dialog box.

OSStatus PMSessionPrintDialogMain (
    PMPrintSession printSession, 
    PMPrintSettings printSettings, 
    PMPageFormat constPageFormat, 
    Boolean *accepted, 
    PMPrintDialogInitUPP myInitProc
);
Parameter descriptions
printSession

A PMPrintSession object.

printSettings

A PMPrintSettings object.

constPageFormat

A PMPageFormat object.

accepted

Returns true if the user clicks the OK button, or false if the user clicks Cancel.

myInitProc

A universal procedure pointer to your dialog initialization function. Your initialization function is defined by the callback PMPrintDialogInitProcPtr.

function result

A result code. A result code. See “Result Codes”.

DISCUSSION

The Carbon Printing Manager calls your dialog initialization function before displaying your custom Print dialog box. Your initialization function can append items to the Print dialog box, and should install an event filter using the PMSetModalFilterProc function. You must pass the same PMPageFormat and PMPrintSession objects to both PMSessionPrintDialogMain and PMSessionPrintDialogInit.

SPECIAL CONSIDERATIONS

Valid within the context of a printing session after calling PMSessionPrintDialogInit.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.1 and later when running Mac OS 8.1 or later.

CARBON NOTES

PMSessionPrintDialogMain is equivalent to the Classic Printing Manager function PrDlgMain.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)