Класс QPrintPreviewDialog
Класс QPrintPreviewDialog предоставляет диалоговое окно для предварительного просмотра и настройки макета страницы для вывода на принтер. Подробнее...
| Заголовок: | #include <QPrintPreviewDialog> |
| CMake: | find_package(Qt6 COMPONENTS PrintSupport REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Наследуется от: | QDialog |
Открытые функции
| 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.
Сигнал будет отключен от слота, когда диалоговое окно будет закрыто.
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-6.0/qprintpreviewdialog.html