Visual Basic Reference

Visual Studio 6.0

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.


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.


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.