user-copies

Generic Function

Package: common-graphics

Arguments: printer

Returns the number of copies that the application (rather than the printer driver) should print. If this printer stream property is greater than 1, it indicates that the user has requested on the print job dialog that multiple copies be printed, and furthermore that the printer driver does NOT know how to print the multiple copies itself, and so the application is obligated to explicitly print this number of copies of whatever output is currently being printed.

The number of copies to print may be specified programmatically by passing the :copies initarg to open-stream when creating the printer stream, or may be specified by the end user on the print job dialog that appears by default when calling open-stream to create a printer stream. The values of the driver-copies and user-copies properties will then indicate whether the application or the printer driver should handle printing the multiple copies, if any.

user-copies is a property of the printer class. Note: this generic function is not setf'able.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.