Carbon


PMSetFirstPage

Header: PMCore.h Carbon status: Supported

Sets the default page number of the first page to be printed, as displayed in the Print dialog box.

OSStatus PMSetFirstPage (
    PMPrintSettings printSettings, 
    UInt32 first, 
    Boolean lock
);
Parameter descriptions
printSettings

A PMPrintSettings object.

first

The page number of the first page to print. This value appears in the From field of the Print dialog box.

lock

Pass true to prevent the user from changing the first page value. 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 first value.

SPECIAL CONSIDERATIONS

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 PMSetFirstPagefunction replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and sets information previously stored in the iFstPage field of the Printing Manager structure TPrJob.


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