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.
Public Functions
QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
virtual | ~QPrintPreviewDialog() |
void | open(QObject *receiver, const char *member) |
QPrinter * | printer() |
Reimplemented Public Functions
virtual void | done(int result) override |
virtual void | setVisible(bool visible) override |
- 7 public functions inherited from QDialog
- 188 public functions inherited from QWidget
- 16 public functions inherited from QObject
Related Non-Members
typedef | QObjectList |
Macros
QT_NO_NARROWING_CONVERSIONS_IN_CONNECT | |
QWIDGETSIZE_MAX | |
Q_CLASSINFO(Name, Value) | |
Q_DISABLE_COPY(Class) | |
Q_DISABLE_COPY_MOVE(Class) | |
Q_DISABLE_MOVE(Class) | |
Q_EMIT | |
Q_ENUM(...) | |
Q_ENUM_NS(...) | |
Q_FLAG(...) | |
Q_FLAG_NS(...) | |
Q_GADGET | |
Q_INTERFACES(...) | |
Q_INVOKABLE | |
Q_NAMESPACE | |
Q_OBJECT | |
Q_PROPERTY(...) | |
Q_REVISION | |
Q_SET_OBJECT_NAME(Object) | |
Q_SIGNAL | |
Q_SIGNALS | |
Q_SLOT | |
Q_SLOTS |
Additional Inherited Members
- 2 properties inherited from QDialog
- 59 properties inherited from QWidget
- 1 property inherited from QObject
- 5 public slots inherited from QDialog
- 18 public slots inherited from QWidget
- 1 public slot inherited from QObject
- 3 signals inherited from QWidget
- 1 signal inherited from QObject
- 2 static public members inherited from QWidget
- 5 static public members inherited from QObject
- 6 protected functions inherited from QDialog
- 19 protected functions inherited from QWidget
- 8 protected functions inherited from QObject
- 1 protected slot inherited from QWidget
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.
Member Function Documentation
QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Constructs a QPrintPreviewDialog based on printer and with parent as the parent widget. The widget flags flags are passed on to the QWidget constructor.
See also QWidget::setWindowFlags().
[virtual]
QPrintPreviewDialog::~QPrintPreviewDialog()
Destroys the QPrintPreviewDialog.
[override virtual]
void QPrintPreviewDialog::done(int result)
Reimplements: QDialog::done(int r).
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.
QPrinter *QPrintPreviewDialog::printer()
Returns a pointer to the QPrinter object this dialog is currently operating on.
[override virtual]
void QPrintPreviewDialog::setVisible(bool visible)
Reimplements: QDialog::setVisible(bool visible).