QPrintPreviewDialog 类

QPrintPreviewDialog 类提供了一个用于预览和配置打印机输出页面布局的对话框。 更多信息...

头文件 #include <QPrintPreviewDialog>
CMakefind_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmakeQT += printsupport
继承自 QDialog

公共函数

QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual~QPrintPreviewDialog()
voidopen(QObject *receiver, const char *member)
QPrinter *printer()

重写的公共函数

virtual voiddone(int result) override
virtual voidsetVisible(bool visible) override

信号

voidpaintRequested(QPrinter *printer)

详细描述

在你的现有应用程序中使用 QPrintPreviewDialog 很简单

  1. 创建 QPrintPreviewDialog。

    你可以使用现有的 QPrinter 对象构建 QPrintPreviewDialog,或者你可以让 QPrintPreviewDialog 为你创建一个,这将使用系统默认打印机。

  2. paintRequested() 信号连接到槽。

    当对话框需要生成一组预览页面时,将发出 paintRequested() 信号。你可以使用与生成预览相同的代码进行实际打印,包括调用 QPrinter::newPage() 开始预览中的新页面。将槽连接到 paintRequested() 信号,您将在连接到槽的 QPrinter 对象上绘图。

  3. 调用 exec()。

    调用 QPrintPreviewDialog::exec() 显示预览对话框。

另请参阅QPrinter, QPrintDialog, QPageSetupDialogQPrintPreviewWidget

成员函数文档

[明确] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

根据printerparent构造一个QPrintPreviewDialog,并将flags窗口标志传递给QWidget构造函数。

另请参阅QWidget::setWindowFlags().

[显式] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

这是一个重载函数。

这将创建一个内部QPrinter对象,它将使用系统默认打印机。

[虚函数 noexcept] QPrintPreviewDialog::~QPrintPreviewDialog()

销毁QPrintPreviewDialog

[重写虚函数] void QPrintPreviewDialog::done(int result)

重新实现了: QDialog::done(int r).

void QPrintPreviewDialog::open(QObject *receiver, const char *member)

这是一个重载函数。

打开对话框,并将它的finished(int)信号连接到由receivermember指定的槽。

当对话框关闭时,信号将从槽断开。

[信号] void QPrintPreviewDialog::paintRequested(QPrinter *printer)

QPrintPreviewDialog需要生成一组预览页时,将发出此信号。

提供的printer实例是绘画设备,应在其中绘制每一页的内容,方式与直接打印时相同。

QPrinter *QPrintPreviewDialog::printer()

返回指向此对话框当前操作的QPrinter对象的指针。

[重写虚函数] void QPrintPreviewDialog::setVisible(bool visible)

重新实现了:QDialog::setVisible(bool visible).

© 2024 The Qt Company Ltd. 本文档中包含的贡献是各自所有者的版权。本文档是根据自由软件基金会发布的GNU自由文档许可版本1.3的条款许可的。Qt及其相关标志是芬兰的Qt公司及其在全世界其他国家的商标。所有其他商标均为其各自所有者的财产。