Manager: Carbon Printing Manager


The Carbon Printing Manager interface for applications is defined in the header files PMApplication.h, PMCore.h, and PMDefinitions.h. The Printing Manager interface used on Mac OS 9 and earlier (defined in Printing.h), is not used by Carbon applications.

The following list summarizes the changes you need to be aware of as you convert your existing printing code to use the Carbon Printing Manager. See the Carbon Printing Manager documentation for a detailed discussion of these topics.

The Classic print record (TPrint ) is replaced by two opaque objects: a PMPrintSettings object and a PMPageFormat object. You create these objects using the PMCreatePrintSettings and PMCreatePageFormat functions, which return a reference that you can pass to other Carbon Printing Manager functions to obtain information stored in the objects.

Your application must not make assumptions about the size or content of the PMPrintSettings and PMPageFormat objects. Applications can attach extended data to both these objects using new Carbon Printing Manager functions, but applications must not assume a specific size when storing or retrieving these objects with documents.

The Carbon Printing Manager provides functions for flattening and restoring the PMPrintSettings and PMPageFormat objects. In most cases, your application should store only the PMPageFormat object. If older versions of your application store a Classic print record with a saved document, you may continue to do so for backward compatibility. However, some information may be lost when converting to a Classic print record, due to limitations of the Classic print record structure.

On Mac OS X, Carbon applications can initiate multiple, simultaneous printing tasks. Each printing task is referred to as a session, and each printing session is independent of other printing sessions. On Mac OS 8 and 9, applications are limited to a single printing session.

The Carbon Printing Manager enforces an order in which some routines can be called. Any routine used out of order will return the result code kPMOutOfScope.

The "style" dialog box is now called the Page Setup dialog, and the "job" dialog box is now called the Print dialog.

If your application requires customizing the Page Setup or Print dialogs, you should consider creating a printer dialog extension (PDE). Printer dialog extensions provide more customization capability, and are required to support document-modal dialogs in Mac OS X. For more information, see the document "Extending Printing Dialogs in Mac OS X."

The PrPicFile function and the "deferred" printing style are not supported in Carbon. All print records must use the "draft" style, and printer drivers must perform their own spooling or, on Mac OS 8 and 9, use the Desktop Printer Spooler. See Tech Note 1097 for information about the Desktop Printer Spooler.

Low-level driver functions such as PrLoadDriver are not supported.

Supported  DisposePMIdleUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisposePMItemUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisposePMPageSetupDialogInitUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisposePMPrintDialogInitUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisposePMSheetDoneUPP

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  InvokePMIdleUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  InvokePMItemUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  InvokePMPageSetupDialogInitUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  InvokePMPrintDialogInitUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  InvokePMSheetDoneUPP

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  NewPMIdleUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewPMItemUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewPMPageSetupDialogInitUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewPMPrintDialogInitUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewPMSheetDoneUPP

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMBegin

You should use the function PMCreateSession instead of PMBegin. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMBeginDocument

You should use the function PMSessionBeginDocument instead of PMBeginDocument. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMBeginPage

You should use the function PMSessionBeginPage instead of PMBeginPage. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMConvertOldPrintRecord

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMCopyPageFormat

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMCopyPrintSettings

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMCreatePageFormat

PMCreatePageFormat combined with PMCreatePrintSettings is equivalent to creating a new Classic print record (TPrint). Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMCreatePrintSettings

PMCreatePrintSettings combined with PMCreatePageFormat is equivalent to creating a new Classic Printing Record (TPrint). Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMCreateSession

PMCreateSession is equivalent to the Classic Printing Manager function PrOpen. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMDefaultPageFormat

You should use the function PMSessionDefaultPageFormat instead of PMDefaultPageFormat. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMDefaultPrintSettings

You should use the function PMSessionDefaultPrintSettings instead of PMDefaultPrintSettings. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMDisableColorSync

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMDisposePageFormat

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMDisposePrintSettings

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMEnableColorSync

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMEnd

You should use the function PMRelease instead of PMEnd. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMEndDocument

You should use the function PMSessionEnd instead of PMEndDocument. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMEndPage

You should use the function PMSessionEndPage instead of PMEndPage. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMError

You should use the function PMSessionError instead of PMError. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMFlattenPageFormat

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMFlattenPrintSettings

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGeneral

You should use the function PMSessionGeneral instead of PMGeneral. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetAdjustedPageRect

PMGetAdjustedPageRect is equivalent to getting the Classic print record's TPrInfo.rPage field. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetAdjustedPaperRect

PMGetAdjustedPaperRect is equivalent to getting the Classic print record's rPaper field. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetColorMode

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetCopies

The PMGetCopies function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information formerly stored in the iCopies field of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetDestination

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetDialogAccepted

PMGetDialogAccepted gives you access to the information formerly contained in the fDoIt field of the Printing Manager structure TPrDlg . Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetDialogDone

PMGetDialogDone gives you access to the information formerly contained in the fDone field of the Printing Manager structure TPrDlg . Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetDialogPtr

PMGetDialogPtr gives you access to the information formerly contained in the dlg field of the Printing Manager structure TPrDlg . Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetDriverCreator

The PMGetDriverCreator function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetDriverReleaseInfo

The PMGetDriverReleaseInfo function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information formerly contained in the iPrVersion of the Printing Manager structure TPrint.

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetFirstPage

The PMGetFirstPage function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information previously stored in the iFstPage field of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetGrafPtr

The PMGetGrafPtr function allows access to the pointer formerly stored in the gPort field of the Printing Manager structure TPrPort. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetIndexedPrinterResolution

PMGetIndexedPrinterResolution is equivalent to calling the Classic Printing Manager function PrGeneral with the getRslDataOp opcode and indexing into the TGetRslBlk record. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetItemProc

PMGetItemProc is equivalent to setting the TPrDlg.pItemProc field in the Classic Printing Manager. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetJobName

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetJobNameCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetLanguageInfo

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetLastPage

The PMGetLastPage function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information previously stored in the iLstPage field of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetModalFilterProc

PMGetModalFilterProc is equivalent to setting the TPrDlg.pFltrProc field in the Classic Printing Manager. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetOrientation

The PMGetOrientation function replaces the Printing Manager opcode getRotnOp, and obtains information formerly stored in the lower byte of the wDev field of the Printing Manager structure TPrStl. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetPageFormatExtendedData

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetPageRange

The PMGetPageRange function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information previously stored in the iFstPage and iLstPage fields of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetPhysicalPageSize

The preferred name of this function has been changed to PMGetUnadjustedPageRect. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetPhysicalPaperSize

The preferred name of this function has been changed to PMGetUnadjustedPaperRect. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetPrinterResolution

PMPrinterGetPrinterResolution is recommended instead of PMGetPrinterResolution. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMGetPrinterResolutionCount

PMGetPrinterResolutionCount is equivalent to calling the Classic Printing Manager function PrGeneral with the getRslDataOp opcode. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetPrintSettingsExtendedData

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetResolution

This function replaces the Printing Manager opcode getRslDataOp and allows access to information formerly stored in the iVRes and iHRes fields of the Printing Manager structure TPrInfo. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetScale

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetUnadjustedPageRect

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMGetUnadjustedPaperRect

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMIsPostScriptDriver

PMIsPostScriptDriver is equivalent to testing the high byte of the Classic print record's TPrStl.wDev field (3 = LaserWriter driver). Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMMakeOldPrintRecord

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMNewPageFormat

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMNewPrintSettings

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMPageSetupDialog

You should use the function PMSessionPageSetupDialog instead of PMPageSetupDialog. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMPageSetupDialogInit

You should use the function PMSessionPageSetupDialogInit instead of PMPageSetupDialogInit. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMPageSetupDialogMain

You should use the function PMSessionPageSetupDialogMain instead of PMPageSetupDialogMain. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPostScriptBegin

PMPostScriptBegin is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptBegin picture comment. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPostScriptData

No corresponding Classic Printing Manager function. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPostScriptEnd

PMPostScriptEnd corresponds to calling the Classic Printing Manager function PicComment with the PostScriptEnd picture comment. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPostScriptFile

PMPostScriptFile is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptFile picture comment. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPostScriptHandle

PMPostScriptHandle is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptHandle picture comment. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMPrintDialog

You should use the function PMSessionPrintDialog instead of PMPrintDialog. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMPrintDialogInit

You should use the function PMSessionPrintDialogInit instead of PMPrintDialogInit. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrintDialogInitWithPageFormat

PMPrintDialogInitWithPageFormat is equivalent to the Classic Printing Manager function PrJobInit.. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMPrintDialogMain

You should use the function PMSessionPrintDialogMain instead of PMPrintDialogMain. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetDescriptionURL

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetDriverCreator

For Classic printer drivers that support the PrGeneral opcode kPrinterDirectOpCode, PMPrinterGetDriverCreator provides functionality equivalent to calling PrGeneral, passing in the kPDVerifySelect selector to obtain the driver's creator type and version. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetDriverReleaseInfo

For Classic printer drivers that support the PrGeneral opcode kPrinterDirectOpCode, PMPrinterGetDriverReleaseInfo provides functionality equivalent to calling PrGeneral, passing in the kPDVerifySelect selector to obtain the driver's creator type and version. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetIndexedPrinterResolution

PMPrinterGetIndexedPrinterResolution is equivalent to calling the Classic Printing Manager function PrGeneral with the getRslDataOp opcode and obtaining a value from the TGetRslBlk record. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetLanguageInfo

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetPrinterResolution

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMPrinterGetPrinterResolutionCount

PMPrinterGetPrinterResolutionCount is equivalent to calling the Classic Printing Manager function PrGeneral with the getRslDataOp opcode. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMRelease

PMRelease is equivalent to the Classic Printing Manager function PrClose when the parameter is a PMPrintSession object and its reference count is zero. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMRetain

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionBeginDocument

PMSessionBeginDocument is equivalent to the Classic Printing Manager function PrOpenDoc. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionBeginPage

PMSessionBeginPage is equivalent to the Classic Printing Manager function PrOpenPage. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionConvertOldPrintRecord

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionCopyDestinationFormat

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionCopyDestinationLocation

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionCopyOutputFormatList

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  PMSessionCreatePageFormatList

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  PMSessionCreatePrinterList

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionDefaultPageFormat

PMSessionDefaultPageFormat combined with PMSessionDefaultPrintSettings is equivalent to the Classic Printing Manager function PrintDefault. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionDefaultPrintSettings

PMSessionDefaultPrintSettings combined with PMSessionDefaultPageFormat is equivalent to the Classic Printing Manager function PrintDefault. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionDisableColorSync

PMSessionDisableColorSync is equivalent to calling the Classic Printing Manager function PicComment with the CMDisableMatching picture comment. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionEnableColorSync

PMSessionEnableColorSync is equivalent to calling the Classic Printing Manager function PicComment with the CMEnableMatching picture comment. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionEndDocument

PMSessionEndDocument is equivalent to the Classic Printing Manager function PrCloseDoc. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionEndPage

PMSessionEndPage is equivalent to the Classic Printing Manager function PrClosePage. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionError

Because all Carbon Printing Manager functions return a result code, the PMSessionError function is not required for general error checking, but can be used in your print loop to determine if the user canceled a print job.

PMSessionError is equivalent to the Classic Printing Manager function PrError. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGeneral

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGetCurrentPrinter

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGetDataFromSession

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGetDestinationType

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGetDocumentFormatGeneration

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGetDocumentFormatSupported

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionGetGraphicsContext

PMSessionGetGraphicsContext is equivalent to accessing the Classic Printing Manager's TPrPort.gPort field. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionIsDocumentFormatSupported

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionMakeOldPrintRecord

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPageSetupDialog

PMSessionPageSetupDialog is equivalent to the Classic Printing Manager function PrStlDialog. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPageSetupDialogInit

PMSessionPageSetupDialogInit is equivalent to the Classic Printing Manager function PrStlInit. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPageSetupDialogMain

PMSessionPageSetupDialogMain is equivalent to the Classic Printing Manager function PrDlgMain. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPostScriptBegin

PMSessionPostScriptBegin is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptBegin picture comment. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPostScriptData

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPostScriptEnd

PMSessionPostScriptEnd is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptEnd picture comment. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPostScriptFile

PMSessionPostScriptFile is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptFile picture comment. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPostScriptHandle

PMSessionPostScriptHandle is equivalent to calling the Classic Printing Manager function PicComment with the PostScriptHandle picture comment. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPrintDialog

PMSessionPrintDialog is equivalent to the Classic Printing Manager function PrJobDialog. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPrintDialogInit

PMSessionPrintDialog is equivalent to the Classic Printing Manager function PrJobInit. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionPrintDialogMain

PMSessionPrintDialogMain is equivalent to the Classic Printing Manager function PrDlgMain. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetCurrentPrinter

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetDataInSession

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetDestination

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetDocumentFormatGeneration

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetError

PMSessionSetError is equivalent to the Classic Printing Manager function PrSetError. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetIdleProc

PMSessionSetIdleProc is equivalent to setting the TPrJob.pIdleProc field in the Classic print record (TPrint). Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionSetPSInjectionData

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionUseSheets

Available on Mac OS X only. Sheets are not supported by CarbonLib on Mac OS 8 or 9. Available in CarbonLib 1.2 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionValidatePageFormat

PMSessionValidatePageFormat combined with PMSessionValidatePrintSettings is equivalent to the Classic Printing Manager function PrValidate. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSessionValidatePrintSettings

PMSessionValidatePrintSettings combined with PMSessionValidatePageFormat is equivalent to the Classic Printing Manager function PrValidate. Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetAdjustedPageRect

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetColorMode

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetCopies

The PMSetCopies function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and sets information formerly stored in the iCopies field of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMSetDialogAccepted

PMSetDialogAccepted lets you set information formerly contained in the fDoIt field of the Printing Manager structure TPrDlg . Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMSetDialogDone

PMSetDialogDone lets you set information formerly contained in the fDone field of the Printing Manager structure TPrDlg. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMSetError

You should use the function PMSessionSetError instead of PMSetError. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetFirstPage

The PMSetFirstPagefunction replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and sets information previously stored in the iFstPage field of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMSetIdleProc

PMSetIdleProc is equivalent to setting the TPrJob.pIdleProc field in the Classic print record (TPrint). Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMSetItemProc

The PMSetItemProc function allows you to set the pointer previously contained in the pItemProc field of the Printing Manager function TPrDlg. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetJobName

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetJobNameCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetLastPage

The PMSetLastPagefunction replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and sets information previously stored in the iLstPage field of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMSetModalFilterProc

PMSetModalFilterProc is equivalent to setting the TPrDlg.pFltrProc field in the Classic Printing Manager. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetOrientation

The PMSetOrientation function replaces the Printing Manager opcode getRotnOp, and sets information formerly stored in the lower byte of the wDev field of the Printing Manager structure TPrStl. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetPageFormatExtendedData

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetPageRange

The PMSetPageRangefunction replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and sets information previously stored in the iFstPage and iLstPage fields of the Printing Manager structure TPrJob. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetPhysicalPaperSize

The preferred name of this function has been changed to PMSetUnadjustedPaperRect. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetPrintSettingsExtendedData

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetProfile

PMSetProfile is equivalent to calling the Classic Printing Manager function PicComment with the CMBeginProfile picture comment. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetResolution

This function replaces the Printing Manager opcode getRslDataOp and allows you to change information formerly stored in the iVRes and iHRes fields of the Printing Manager structure TPrInfo. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetScale

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMSetUnadjustedPaperRect

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  PMUnflattenPageFormat

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  PMUnflattenPrintSettings

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMValidatePageFormat

You should use the function PMSessionValidatePageFormat instead of PMValidatePageFormat. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PMValidatePrintSettings

You should use the function PPMSessionValidatePrintSettings instead of PMValidatePrintSettings. Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.