Carbon


PMUnflattenPrintSettings

Header: PMCore.h Carbon status: Supported

Rebuilds a flattened PMPrintSettings object.

OSStatus PMUnflattenPrintSettings (
    Handle flatSettings, 
    PMPrintSettings *printSettings
);
Parameter descriptions
flatSettings

A handle to a previously flattened PMPrintSettings object. Your application must dispose of this handle.

printSettings

A pointer to the address where the newly created PMPringSettings object should be stored. On return, this object contains the data retrieved from the flattened print settings.

function result

A result code. A result code. See “Result Codes”. The result code kPMInvalidParameter is returned if the flattened PMPrintSettings object was created by an incompatible version of the Carbon Printing Manager. In this case your application should display the Print dialog box to allow the user to enter the desired settings.

DISCUSSION

The PMUnflattenPrintSettings function creates a new PMPrintSettings object containing the information from the flattened print settings.

SPECIAL CONSIDERATIONS

Unlike most Carbon Printing Manager functions, you may call this function outside of a printing session or PMBegin/PMEnd block.

VERSION NOTES

There are no restrictions on when you may use this function.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.


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