Carbon


PMSessionPageSetupDialogInit

Header: PMApplication.h Carbon status: Supported

Initializes a custom Page Setup dialog box.

OSStatus PMSessionPageSetupDialogInit (
    PMPrintSession printSession, 
    PMPageFormat pageFormat, 
    PMDialog *newDialog
);
Parameter descriptions
printSession

A PMPrintSession object.

pageFormat

A PMPageFormat object.

newDialog

On return, a pointer to an initialized PMDialog object, ready for customization by your application. Because the PMSessionPageSetupDialogMain function does not include a parameter for passing this PMDialog object to your dialog initialization callback function, your application should store this pointer in a global variable or as extended data in the PMPageFormat object. See the discussion of the PMPageSetupDialogInitProcPtr callback function for more information.

function result

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

SPECIAL CONSIDERATIONS

Valid within the context of a printing session after creating a page format object.

AVAILABILITY

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

CARBON NOTES

PMSessionPageSetupDialogInit is equivalent to the Classic Printing Manager function PrStlInit.


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