Qt Reference Documentation

# Obsolete Members for QPrinter

The following class members are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.

- QPrinter class reference

## Public Types

enum | PageSize { A0, A1, A2, A3, ..., Custom }`(obsolete)`

## Public Functions

int | actualNumCopies () const`(obsolete)`
int | numCopies () const`(obsolete)`
PageSize | pageSize () const`(obsolete)`
void | setNumCopies ( int numCopies )`(obsolete)`
void | setPageSize ( PageSize newPageSize )`(obsolete)`

## Member Type Documentation

### enum QPrinter::PageSize

Use QPrinter::PaperSize instead.

Constant | Value | Description
--- | --- | ---
`QPrinter::A0` | `5` | 841 x 1189 mm
`QPrinter::A1` | `6` | 594 x 841 mm
`QPrinter::A2` | `7` | 420 x 594 mm
`QPrinter::A3` | `8` | 297 x 420 mm
`QPrinter::A4` | `0` | 210 x 297 mm, 8.26 x 11.69 inches
`QPrinter::A5` | `9` | 148 x 210 mm
`QPrinter::A6` | `10` | 105 x 148 mm
`QPrinter::A7` | `11` | 74 x 105 mm
`QPrinter::A8` | `12` | 52 x 74 mm
`QPrinter::A9` | `13` | 37 x 52 mm
`QPrinter::B0` | `14` | 1030 x 1456 mm
`QPrinter::B1` | `15` | 728 x 1030 mm
`QPrinter::B10` | `16` | 32 x 45 mm
`QPrinter::B2` | `17` | 515 x 728 mm
`QPrinter::B3` | `18` | 364 x 515 mm
`QPrinter::B4` | `19` | 257 x 364 mm
`QPrinter::B5` | `1` | 182 x 257 mm, 7.17 x 10.13 inches
`QPrinter::B6` | `20` | 128 x 182 mm
`QPrinter::B7` | `21` | 91 x 128 mm
`QPrinter::B8` | `22` | 64 x 91 mm
`QPrinter::B9` | `23` | 45 x 64 mm
`QPrinter::C5E` | `24` | 163 x 229 mm
`QPrinter::Comm10E` | `25` | 105 x 241 mm, U.S. Common 10 Envelope
`QPrinter::DLE` | `26` | 110 x 220 mm
`QPrinter::Executive` | `4` | 7.5 x 10 inches, 191 x 254 mm
`QPrinter::Folio` | `27` | 210 x 330 mm
`QPrinter::Ledger` | `28` | 432 x 279 mm
`QPrinter::Legal` | `3` | 8.5 x 14 inches, 216 x 356 mm
`QPrinter::Letter` | `2` | 8.5 x 11 inches, 216 x 279 mm
`QPrinter::Tabloid` | `29` | 279 x 432 mm
`QPrinter::Custom` | `30` | Unknown, or a user defined size.

## Member Function Documentation

### int QPrinter::actualNumCopies () const

Returns the number of copies that will be printed. The default value is 1.

This function always returns the actual value specified in the print dialog or using setNumCopies().

Use copyCount() instead.

This function was introduced in Qt 4.6.

See also setNumCopies() and numCopies().

### int QPrinter::numCopies () const

Returns the number of copies to be printed. The default value is 1.

On Windows, Mac OS X and X11 systems that support CUPS, this will always return 1 as these operating systems can internally handle the number of copies.

On X11, this value will return the number of times the application is required to print in order to match the number specified in the printer setup dialog. This has been done since some printer drivers are not capable of buffering up the copies and in those cases the application must make an explicit call to the print code for each copy.

Use copyCount() in conjunction with supportsMultipleCopies() instead.

See also setNumCopies() and actualNumCopies().

### PageSize QPrinter::pageSize () const

Returns the printer page size. The default value is driver-dependent.

Use paperSize() instead.

See also setPageSize().

### void QPrinter::setNumCopies ( int numCopies )

Sets the number of copies to be printed to numCopies.

The printer driver reads this setting and prints the specified number of copies.

Use setCopyCount() instead.

See also numCopies().

### void QPrinter::setPageSize ( PageSize newPageSize )

Sets the printer page size based on newPageSize.

Use setPaperSize() instead.

See also pageSize().