Carbon


PMSessionUseSheets

Header: PMApplication.h Carbon status: Under Evaluation

Specifies that a printing dialog be displayed as a sheet.

OSStatus PMSessionUseSheets (
    PMPrintSession printSession, 
    WindowRef documentWindow, 
    PMSheetDoneUPP sheetDoneProc
);
Parameter descriptions
printSession

A PMPrintSession object.

documentWindow

The WindowRef object that the printing dialog sheet will be attached to.

sheetDoneProc

A universal procedure pointer to your sheet done function. The Carbon Printing Manager calls this function when the user dismisses the dialog. Your sheet done function is defined by the callback PMSheetDoneProcPtr.

function result

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

DISCUSSION

When a printing dialog is displayed as a sheet, calls to the functions PMSessionPageSetupDialog and PMSessionPrintDialog return control immediately to your application, with the value of the accepted parameter undefined. The printing dialog sheet will continue to be displayed until the user dismisses the dialog. The PMPageFormat or PMPrintSettings object associated with the dialog is not valid until the Carbon Printing Manager calls your sheet done function.

SPECIAL CONSIDERATIONS

Dialogs that have been customized using the classic AppendDITL method cannot be displayed as sheets. Calling PMSessionUseSheets for a custom dialog has no effect. You must create a printing dialog extension to display custom elements in a sheet. See the document Extending Printing Dialogs in Mac OS X for more information.

Valid within the context of a printing session.

AVAILABILITY

Under evaluation for Carbon. Not available in Carbon.


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