Carbon


PMSetOrientation

Header: PMCore.h Carbon status: Supported

Sets the page orientation for printing.

OSStatus PMSetOrientation (
    PMPageFormat pageFormat, 
    PMOrientation orientation, 
    Boolean lock
);
Parameter descriptions
pageFormat

A PMPageFormat object.

orientation

The desired orientation setting. See “Page Orientation Constants” for a list of values you can use to specify page orientation.

lock

Pass true to prevent the user from changing the orientation. Locking is supported only on Mac OS X.

function result

A result code. A result code. See “Result Codes”. The result code kPMLockIgnored indicates that the printer driver does not support locking of the orientation value.

SPECIAL CONSIDERATIONS

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 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.


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