Carbon


PMSetUnadjustedPaperRect

Header: PMCore.h Carbon status: Under Evaluation

Requests a particular paper size, unaffected by rotation, resolution or scaling.

OSStatus PMSetUnadjustedPaperRect (
    PMPageFormat pageFormat, 
    const PMRect *paperRect
);
Parameter descriptions
pageFormat

A PMPageFormat object.

paperRect

A rectangle describing the desired paper size, in points.

function result

A result code. A result code. See “Result Codes”. The result code kPMValueOutOfRange indicates that the printer driver does not support the requested page size.

DISCUSSION

After using this function you should always call PMGetUnadjustedPaperRect to verify the paper size recorded by the printer driver.

SPECIAL CONSIDERATIONS

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

VERSION NOTES

In CarbonLib 1.0 this function was named PMSetPhysicalPaperSize. You can still use PMSetPhysicalPaperSize, but the recommended name is PMSetUnadjustedPaperRect.

AVAILABILITY

Under evaluation for Carbon. Available in Carbon 1.1 and later when CarbonLib 1.1 or later is present.


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