Carbon


PMBeginDocument

Header: PMApplication.h Carbon status: Supported

Establishes a graphics context for imaging a document. This context is an opaque grafPort.

OSStatus PMBeginDocument (
    PMPrintSettings printSettings, 
    PMPageFormat pageFormat, 
    PMPrintContext *printContext
);
Parameter descriptions
printSettings

A PMPrintSettings object.

pageFormat

A PMPageFormat object.

printContext

On return, an initialized PMPrintContext object.

function result

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

DISCUSSION

PMSessionBeginDocument is recommended instead of PMBeginDocument.

SPECIAL CONSIDERATIONS

Valid within a PMBegin/PMEnd bock. You must balance a call to PMBeginDocument with a call to PMEndDocument.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.

CARBON NOTES

The PMBeginDocument function replaces the Printing Manager function PrOpenDoc.

The Printing Manager function PrOpenDoc included a parameter that pointed to an input and output buffer. For Carbon, drivers are assumed to be handling I/O buffering. Therefore, PMBeginDocument has no similar parameter.


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