Visual Basic Reference
Copies Property
See Also Example Applies To
Returns or sets a value that determines the number of copies to be printed. For the Printer object, not available at design time.
Syntax
object.Copies [= number]
The Copies property syntax has these parts:
| Part | Description |
| Object | An object expression that evaluates to an object in the Applies To list. |
| Number | A numeric expression that specifies the number of copies to print. This value must be an integer. |
Remarks
For the Print dialog box, this property returns the number of copies entered by the user in the Copies box. If the cdlPDUseDevModeCopies flag is set for the CommonDialog control, this property always returns 1.
For the Printer object, multiple copies may or may not be collated, depending on the printer driver. Multiple copies of the entire document or multiple copies of each page may be printed. For printers that don't support collating, set Copies = 1, and then use a loop in code to print multiple copies of the entire document.
Note The effect of the properties of the Printer object depends on the driver supplied by the printer manufacturer. Some property settings may have no effect, or several different property settings may all have the same effect. Settings outside the accepted range may produce an error. For more information, see the manufacturer's documentation for the specific driver.