Carbon


kPMCancel

Header: PMDefinitions.h

Indicates that the user canceled a printing operation.

enum {
    kPMCancel = 128,
    kPMNoData = 0,
    kPMDontWantSize = 0,
    kPMDontWantData = 0,
    kPMDontWantBoolean = 0,
    kPMNoPrintSettings = 0,
    kPMNoPageFormat = 0,
    kPMNoReference = 0
};

Constant descriptions

kPMCancel

User click of the Cancel button in a job or page setup dialog box.

kPMNoData

Specifies that your application does not need data returned for a particular parameter. For future compatibility, you are encouraged to use one of the following constants in cases where a specific type of data is not required.

kPMDontWantSize

Specifies that your application does not need the size information returned by the Carbon Printing Manager.

kPMDontWantData

Specifies that your application does not need the data returned by the Carbon Printing Manager.

kPMDontWantBoolean

Specifies that your application does not need a Boolean value returned by the Carbon Printing Manager.

kPMNoPrintSettings

Specifies that your application does not need a PMPrintSettings object returned by the Carbon Printing Manager.

kPMNoPageFormat

Specifies that your application does not need a PMPageFormat object returned by the Carbon Printing Manager.

kPMNoReference

Specifies that your application does not need an address pointer returned by the Carbon Printing Manager.

This constant is provided for compatibility with Classic applications and printer drivers that expect the iPrAbort error code to be returned when the user cancels a printing operation.

The Carbon Printing Manager’s default idle function checks for Command-period keyboard events during printing, and sets the error condition equal to kPMCancel if one occurs. Your application can check for this condition using the PMSessionError function, and should cancel the print job if kPMCancel is returned.

If you supply your own idle function, it must check for Command-period keyboard events, and set the error condition using PMSessionSetError( kPMCancel ).


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