QAbstractPrintDialog Class▲
-
Header: QAbstractPrintDialog
-
qmake: QT += printsupport
-
Inherits: QDialog
-
Inherited By: QPrintDialog
-
Group: QAbstractPrintDialog is part of Printer and Printing APIs
Detailed Description▲
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▲
See also QPrintDialog, QPrinter
Member Type Documentation▲
enum QAbstractPrintDialog::PrintDialogOption▲
flags 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▲
See also QPrinter::PrintRange
Member Function Documentation▲
[explicit] 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()▲
Reimplements: 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▲
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.
[since 4.4] 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)▲
int QAbstractPrintDialog::toPage() const▲
Returns the last page to be printed. By default, this value is set to 0.
Obsolete Members for QAbstractPrintDialog▲
The following members of class QAbstractPrintDialog are deprecated. We strongly advise against using them in new code.
Obsolete Member Function Documentation▲
void QAbstractPrintDialog::addEnabledOption(QAbstractPrintDialog::PrintDialogOption option)▲
This function is deprecated. We strongly advise against using it in new code.
Use QPrintDialog::setOption(option, true) instead.
QAbstractPrintDialog::PrintDialogOptions QAbstractPrintDialog::enabledOptions() const▲
This function is deprecated. We strongly advise against using it in new code.
Use QPrintDialog::options() instead.
See Also▲
See also setEnabledOptions()
bool QAbstractPrintDialog::isOptionEnabled(QAbstractPrintDialog::PrintDialogOption option) const▲
This function is deprecated. We strongly advise against using it in new code.
Use QPrintDialog::testOption(option) instead.
void QAbstractPrintDialog::setEnabledOptions(QAbstractPrintDialog::PrintDialogOptions options)▲
This function is deprecated. We strongly advise against using it in new code.
Use QPrintDialog::setOptions() instead.
See Also▲
See also enabledOptions()