Класс QPrintPreviewDialog
Класс QPrintPreviewDialog предоставляет диалоговое окно для предварительного просмотра и настройки макета страницы для печати. Подробнее...
| Заголовок: | #include <QPrintPreviewDialog> |
| qmake: | QT += printsupport |
| С тех пор: | Qt 4.4 |
| Наследует: | QDialog |
Этот класс был представлен в Qt 4.4.
Открытые функции
| QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QPrintPreviewDialog() |
| void | open(QObject *receiver, const char *member) |
| QPrinter * | printer() |
Переопределённые открытые функции
| virtual void | done(int result) override |
| virtual void | setVisible(bool visible) override |
Сигналы
| void | paintRequested(QPrinter *printer) |
Подробное описание
Использование QPrintPreviewDialog в вашем существующем приложении простое:
- Создайте QPrintPreviewDialog.
Вы можете создать QPrintPreviewDialog с существующим объектом QPrinter, или вы можете позволить QPrintPreviewDialog создать его для вас, используя системный принтер по умолчанию.
- Подключите сигнал paintRequested() к слоту.
Когда диалоговое окно необходимо сгенерировать набор страниц предварительного просмотра, будет испущен сигнал paintRequested(). Вы можете использовать тот же код для фактической печати, что и для генерации предварительного просмотра, включая вызов QPrinter::newPage() для начала новой страницы в предварительном просмотре. Подключите слот к сигналу paintRequested(), где вы рисуете на объекте QPrinter, переданном в слот.
- Вызовите exec().
Вызовите QPrintPreviewDialog::exec(), чтобы отобразить диалоговое окно предварительного просмотра.
См. также QPrinter, QPrintDialog, QPageSetupDialog и QPrintPreviewWidget.
Документация по функциям-членам
QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Создаёт QPrintPreviewDialog на основе printer и с parent в качестве родительского виджета. Флаги виджета flags передаются конструктору QWidget.
См. также QWidget::setWindowFlags().
QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Это перегруженная функция.
Это создаст внутренний объект QPrinter, который будет использовать системный принтер по умолчанию.
[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)
Этот сигнал испускается, когда QPrintPreviewDialog необходимо сгенерировать набор страниц предварительного просмотра.
Переданный объект printer — это устройство рисования, на котором вы должны нарисовать содержимое каждой страницы, используя объект QPrinter так же, как вы бы делали при прямой печати.
[virtual] QPrintPreviewDialog::~QPrintPreviewDialog()
Уничтожает QPrintPreviewDialog.
[override virtual] void QPrintPreviewDialog::done(int result)
Переопределяет: QDialog::done(int r).
void QPrintPreviewDialog::open(QObject *receiver, const char *member)
Это перегруженная функция.
Открывает диалоговое окно и подключает его сигнал finished(int) к слоту, указанному receiver и member.
Сигнал будет отключён от слота при закрытии диалогового окна.
Эта функция была представлена в Qt 4.5.
QPrinter *QPrintPreviewDialog::printer()
Возвращает указатель на объект QPrinter, с которым в данный момент работает это диалоговое окно.
[override virtual] void QPrintPreviewDialog::setVisible(bool visible)
Переопределяет: QDialog::setVisible(bool visible).
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qprintpreviewdialog.html