Carbon


PMGetOrientation

Header: PMCore.h Carbon status: Supported

Obtains the current setting for page orientation.

OSStatus PMGetOrientation (
    PMPageFormat pageFormat, 
    PMOrientation *orientation
);
Parameter descriptions
pageFormat

A PMPageFormat object.

orientation

On return, a value representing the page orientation. See “Page Orientation Constants” for a list of possible return values.

function result

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

SPECIAL CONSIDERATIONS

Before using this function you must call PMSessionValidatePageFormat or PMValidatePageFormat to ensure that the page format object is valid.

Valid within a printing session after creating a page format object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.

CARBON NOTES

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.


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