|qmake:||QT += printsupport|
|QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = ...)|
|QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = ...)|
|void||open(QObject *receiver, const char *member)|
- 8 public functions inherited from QDialog
- 216 public functions inherited from QWidget
- 31 public functions inherited from QObject
- 14 public functions inherited from QPaintDevice
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
- 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
The QPrintPreviewDialog class provides a dialog for previewing and configuring page layouts for printer output.
Using QPrintPreviewDialog in your existing application is straightforward:
- Create the QPrintPreviewDialog.
- Connect the paintRequested() signal to a slot.
When the dialog needs to generate a set of preview pages, the paintRequested() signal will be emitted. You can use the exact same code for the actual printing as for having the preview generated, including calling QPrinter::newPage() to start a new page in the preview. Connect a slot to the paintRequested() signal, where you draw onto the QPrinter object that is passed into the slot.
- Call exec().
Call QPrintPreviewDialog::exec() to show the preview dialog.
Member Function Documentation
QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = ...)
See also QWidget::setWindowFlags().
QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = ...)
This is an overloaded function.
This will create an internal QPrinter object, which will use the system default printer.
Destroys the QPrintPreviewDialog.
Reimplemented from QDialog::done().
void QPrintPreviewDialog::open(QObject *receiver, const char *member)
This is an overloaded function.
Opens the dialog and connects its finished(int) signal to the slot specified by receiver and member.
The signal will be disconnected from the slot when the dialog is closed.
This function was introduced in Qt 4.5.
[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)
This signal is emitted when the QPrintPreviewDialog needs to generate a set of preview pages.
The printer instance supplied is the paint device onto which you should paint the contents of each page, using the QPrinter instance in the same way as you would when printing directly.
Returns a pointer to the QPrinter object this dialog is currently operating on.
Reimplemented from QDialog::setVisible().
© 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.