QPrintPreviewDialog Class
QPrintPreviewDialog 类提供了一个用于预览和配置打印机输出页面布局的对话框。更多
| Header： | #include <QPrintPreviewDialog> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake： | QT += printsupport |
| 继承： | QDialog |
- 所有成员（包括继承成员）的列表
- QPrintPreviewDialog 是标准对话框和打印机及打印 API 的一部分。
公共函数
| 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。
您可以使用现有的QPrinter 对象构建 QPrintPreviewDialog，也可以让 QPrintPreviewDialog 为您创建一个系统默认打印机。
- 将paintRequested() 信号连接到一个插槽。
当对话框需要生成一组预览页面时，就会发出paintRequested() 信号。您可以使用与生成预览页面完全相同的代码进行实际打印，包括调用QPrinter::newPage() 在预览页面中开始打印新页面。将一个插槽连接到paintRequested() 信号上，在该插槽中绘制传入的QPrinter 对象。
- 调用exec()
调用QPrintPreviewDialog::exec() 显示预览对话框。
另请参阅 QPrinter,QPrintDialog,QPageSetupDialog 和QPrintPreviewWidget 。
成员函数文档
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
构建基于printer 的 QPrintPreviewDialog，并将parent 作为父窗口部件。部件标志flags 将传递给QWidget 构造函数。
另请参阅 QWidget::setWindowFlags().
[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
这是一个重载函数。
它将创建一个内部QPrinter 对象，该对象将使用系统默认打印机。
[virtual noexcept] 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 指定的槽。
关闭对话框时，信号将从槽中断开。
[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)
当QPrintPreviewDialog 需要生成一组预览页面时，就会发出该信号。
所提供的printer 实例是油漆设备，您应将每一页的内容油漆到该设备上，使用QPrinter 实例的方式与直接打印时相同。
QPrinter *QPrintPreviewDialog::printer()
返回指向QPrinter 对象的指针，该对话框当前正在运行。
[override virtual] void QPrintPreviewDialog::setVisible(bool visible)
重实现：QDialog::setVisible(bool visible)。
© 2025 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.
