Carbon


PMSetCopies

Header: PMCore.h Carbon status: Supported

Sets the default value to be displayed in the Print dialog box for the number of copies to be printed.

OSStatus PMSetCopies (
    PMPrintSettings printSettings, 
    UInt32 copies, 
    Boolean lock
);
Parameter descriptions
printSettings

A PMPrintSettings object.

copies

The requested default value for the number of copies to print.

lock

Pass true to prevent the user from changing the number of copies. 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 copies 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 PMSetCopies function replaces the Printing Manager opcode kPrinterDirectOpCode in kPDVerifySelect mode, and sets information formerly stored in the iCopies field of the Printing Manager structure TPrJob.


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