Carbon


PMGetLastPage

Header: PMCore.h Carbon status: Supported

Obtains the number of the last page to be printed.

OSStatus PMGetLastPage (
    PMPrintSettings printSettings, 
    UInt32 *last
);
Parameter descriptions
printSettings

A PMPrintSettings object.

last

On return, a pointer to a variable containing the page number of the last page to print.

function result

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

DISCUSSION

You use this function to obtain the page number entered by the user in the To field of the Print dialog box. If the user did not enter a value, the function returns the value of the previous call to PMSetLastPage, if any, or the default value. On Mac OS 8 and 9, the default and maximum last page number is 9999. On Mac OS X, the default and maximum last page number is MAX_INT(UInt32).

SPECIAL CONSIDERATIONS

Before using this function you must call PMSessionValidatePrintSettings or PMValidatePrintSettings to ensure that the print settings object is valid.

Valid within a printing session after creating a print settings object.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later.

CARBON NOTES

The PMGetLastPage function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and obtains information previously stored in the iLstPage field of the Printing Manager structure TPrJob.


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