Carbon


PMSessionPageSetupDialogMain

Header: PMApplication.h Carbon status: Supported

Displays your application’s custom Page Setup dialog box.

OSStatus PMSessionPageSetupDialogMain (
    PMPrintSession printSession, 
    PMPageFormat pageFormat, 
    Boolean *accepted, 
    PMPageSetupDialogInitUPP myInitProc
);
Parameter descriptions
printSession

A PMPrintSession object.

pageFormat

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 PMPageSetupDialogInitProcPtr.

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 Page Setup dialog box. Your initialization function can append items to the Page Setup dialog box, and should install an event filter using the PMSetModalFilterProc function. You must pass the same PMPageFormat and PMPrintSession objects to both PMSessionPageSetupDialogMain and PMSessionPageSetupDialogInit.

SPECIAL CONSIDERATIONS

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

AVAILABILITY

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

CARBON NOTES

PMSessionPageSetupDialogMain is equivalent to the Classic Printing Manager function PrDlgMain.


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