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

Public Functions

Member Type Documentation

enum QPrinter::PageSize

Use QPrinter::PaperSize instead.

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().