QPrintPreviewDialog Class
The QPrintPreviewDialog class provides a dialog for previewing and configuring page layouts for printer output. More...
| Header: | #include <QPrintPreviewDialog> |
| qmake: | QT += printsupport |
| Since: | Qt 4.4 |
| Inherits: | QDialog |
This class was introduced in Qt 4.4.
Detailed Description
Using QPrintPreviewDialog in your existing application is straightforward:
- Create the QPrintPreviewDialog.
You can construct a QPrintPreviewDialog with an existing QPrinter object, or you can have QPrintPreviewDialog create one for you, which will be the system default printer.
- 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.
See also QPrinter, QPrintDialog, QPageSetupDialog, and QPrintPreviewWidget.