Copies Property (ACommonDialog)

Returns or sets a value that determines the number of copies to be printed.

Syntax

Object.Copies [ = lCopies ]

The Copies property syntax has the following parts:

 

Name

Type

Description

Object

ACommonDialog

ACommonDialog control

lCopies

Long

An integer specifying the number of copies to be printed.

Comments

The property is only available at run time.

For the Print dialog box, this property returns the number of copies entered by the user in the Copies box.

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 do not 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.

Example

The following example will set the number of copies to be printed to four copies:

cdlg1.Copies=4

Applies to

ACommonDialog

See Also

PrinterDefault, PrintOptions, ShowPrint