QAbstractPrintDialog Class

The QAbstractPrintDialog class provides a base implementation for print dialogs used to configure printers. More...

Header:	#include <QAbstractPrintDialog>
qmake:	QT += printsupport
Inherits:	QDialog
Inherited By:	QPrintDialog

• List of all members, including inherited members
• Obsolete members

Public Types

enum	PrintDialogOption { None, PrintToFile, PrintSelection, PrintPageRange, ..., DontUseSheet }
flags	PrintDialogOptions
enum	PrintRange { AllPages, Selection, PageRange, CurrentPage }

Public Functions

	QAbstractPrintDialog(QPrinter *printer, QWidget *parent = nullptr)
int	fromPage() const
int	maxPage() const
int	minPage() const
QAbstractPrintDialog::PrintRange	printRange() const
QPrinter *	printer() const
void	setFromTo(int from, int to)
void	setMinMax(int min, int max)
void	setOptionTabs(const QList<QWidget *> &tabs)
void	setPrintRange(QAbstractPrintDialog::PrintRange range)
int	toPage() const

Reimplemented Public Functions

virtual int

exec() override = 0

• 8 public functions inherited from QDialog
• 216 public functions inherited from QWidget
• 31 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Static Public Members

const QMetaObject

staticMetaObject

• 5 static public members inherited from QWidget
• 9 static public members inherited from QObject

Additional Inherited Members

• 2 properties inherited from QDialog
• 59 properties inherited from QWidget
• 1 property inherited from QObject
• 5 public slots inherited from QDialog
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 3 signals inherited from QDialog
• 3 signals inherited from QWidget
• 2 signals inherited from QObject
• 6 protected functions inherited from QDialog
• 35 protected functions inherited from QWidget
• 9 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QWidget

Detailed Description

The QAbstractPrintDialog class provides a base implementation for print dialogs used to configure printers.

This class implements getter and setter functions that are used to customize settings shown in print dialogs, but it is not used directly. Use QPrintDialog to display a print dialog in your application.

See also QPrintDialog and QPrinter.

Member Type Documentation

enum QAbstractPrintDialog::PrintDialogOptionflags QAbstractPrintDialog::PrintDialogOptions

Used to specify which parts of the print dialog should be visible.

Constant	Value	Description
QAbstractPrintDialog::None	0x0000	None of the options are enabled.
QAbstractPrintDialog::PrintToFile	0x0001	The print to file option is enabled.
QAbstractPrintDialog::PrintSelection	0x0002	The print selection option is enabled.
QAbstractPrintDialog::PrintPageRange	0x0004	The page range selection option is enabled.
QAbstractPrintDialog::PrintShowPageSize	0x0008	Show the page size + margins page only if this is enabled.
QAbstractPrintDialog::PrintCollateCopies	0x0010	The collate copies option is enabled
QAbstractPrintDialog::PrintCurrentPage	0x0040	The print current page option is enabled

This value is obsolete and does nothing since Qt 4.5:

Constant	Value	Description
QAbstractPrintDialog::DontUseSheet	0x0020	In previous versions of Qt, exec() the print dialog would create a sheet by default the dialog was given a parent. This is no longer supported in Qt 4.5. If you want to use sheets, use QPrintDialog::open() instead.

The PrintDialogOptions type is a typedef for QFlags<PrintDialogOption>. It stores an OR combination of PrintDialogOption values.

enum QAbstractPrintDialog::PrintRange

Used to specify the print range selection option.

Constant	Value	Description
QAbstractPrintDialog::AllPages	0	All pages should be printed.
QAbstractPrintDialog::Selection	1	Only the selection should be printed.
QAbstractPrintDialog::PageRange	2	The specified page range should be printed.
QAbstractPrintDialog::CurrentPage	3	Only the currently visible page should be printed.

See also QPrinter::PrintRange.

Member Function Documentation

QAbstractPrintDialog::QAbstractPrintDialog(QPrinter *printer, QWidget *parent = nullptr)

Constructs an abstract print dialog for printer with parent as parent widget.

[override pure virtual] int QAbstractPrintDialog::exec()

Reimplemented from QDialog::exec().

This virtual function is called to pop up the dialog. It must be reimplemented in subclasses.

int QAbstractPrintDialog::fromPage() const

Returns the first page to be printed By default, this value is set to 0.

int QAbstractPrintDialog::maxPage() const

Returns the maximum page in the page range. As of Qt 4.4, this function returns INT_MAX by default. Previous versions returned 1 by default.

int QAbstractPrintDialog::minPage() const

Returns the minimum page in the page range. By default, this value is set to 1.

QAbstractPrintDialog::PrintRange QAbstractPrintDialog::printRange() const

Returns the print range.

See also setPrintRange().

QPrinter *QAbstractPrintDialog::printer() const

Returns the printer that this printer dialog operates on.

void QAbstractPrintDialog::setFromTo(int from, int to)

Sets the range in the print dialog to be from from to to.

void QAbstractPrintDialog::setMinMax(int min, int max)

Sets the page range in this dialog to be from min to max. This also enables the PrintPageRange option.

void QAbstractPrintDialog::setOptionTabs(const QList<QWidget *> &tabs)

Set a list of widgets as tabs to be shown on the print dialog, if supported.

Currently this option is only supported on X11.

Setting the option tabs will transfer their ownership to the print dialog.

This function was introduced in Qt 4.4.

void QAbstractPrintDialog::setPrintRange(QAbstractPrintDialog::PrintRange range)

Sets the print range option in to be range.

See also printRange().

int QAbstractPrintDialog::toPage() const

Returns the last page to be printed. By default, this value is set to 0.