PyQt 如何使用 QPrinter 和 QPrintPreviewDialog

在本文中，我们将介绍如何使用 PyQt 中的 QPrinter 和 QPrintPreviewDialog 类来实现打印和打印预览的功能。

阅读更多：PyQt 教程

1. QPrinter 的基本用法

QPrinter 类是 PyQt 中用于管理打印操作的类。我们可以通过该类设置打印机的一些属性，如打印模式、纸张大小和打印范围等。

首先，我们需要导入相应的模块和类：

from PyQt5.QtGui import QPrinter

接下来，我们可以创建一个 QPrinter 对象，并进行一些常用属性的设置：

printer = QPrinter()
printer.setPageSize(QPrinter.A4)  # 设置纸张大小为A4
printer.setOrientation(QPrinter.Portrait)  # 设置打印方向为纵向

除了上述设置外，我们还可以通过 QPrinter 的其他方法来设置打印模式、打印范围等属性。通过调用打印机对象的方法，我们可以输出文档到文件或打印机：

printer.setOutputFormat(QPrinter.PdfFormat)  # 设置输出格式为PDF
printer.setOutputFileName("output.pdf")  # 设置输出文件名

# 或者打印到打印机
printer.setOutputFormat(QPrinter.NativeFormat)  # 设置输出格式为本地打印机
printer.setDocName("My Document")  # 设置文档名称

# 输出文档到文件或打印机
your_widget.print(printer)

2. QPrintPreviewDialog 的使用

QPrintPreviewDialog 类提供了一个打印预览对话框，可以在该对话框中查看打印输出的效果，并进行相关的设置。

我们首先需要导入相应的类：

from PyQt5.QtPrintSupport import QPrintPreviewDialog

接下来，我们可以创建一个 QPrintPreviewDialog 对象，并设置相应的打印机：

printer = QPrinter()
preview_dialog = QPrintPreviewDialog(printer)

由于 QPrintPreviewDialog 是一个对话框，我们可以设置对话框的标题和窗口尺寸等属性：

preview_dialog.setWindowTitle("Print Preview")

# 设置对话框的大小
preview_dialog.resize(800, 600)

打开对话框并显示打印预览：

preview_dialog.exec_()

我们也可以在打印预览对话框中添加一些自定义的操作，如添加自定义的工具栏按钮：

toolbar = preview_dialog.findChild(QToolBar)
custom_button = QAction("Custom Button", toolbar)
# 然后可以连接自定义按钮的点击事件，执行相应的操作
custom_button.triggered.connect(custom_function)
toolbar.addAction(custom_button)

3. 示例说明

为了更好地理解如何使用 QPrinter 和 QPrintPreviewDialog，下面给出一个完整的示例代码：

from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QTextEdit, QPushButton
from PyQt5.QtGui import QPainter, QTextDocument, QTextCursor
from PyQt5.QtPrintSupport import QPrintPreviewDialog, QPrinter


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("Print Example")

        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)
        self.layout = QVBoxLayout(self.central_widget)

        self.text_edit = QTextEdit()
        self.layout.addWidget(self.text_edit)

        self.print_button = QPushButton("Print")
        self.print_button.clicked.connect(self.print_document)
        self.layout.addWidget(self.print_button)

        self.preview_button = QPushButton("Print Preview")
        self.preview_button.clicked.connect(self.preview_document)
        self.layout.addWidget(self.preview_button)

        self.document = QTextDocument()

    def print_document(self):
        printer = QPrinter()
        printer.setPageSize(QPrinter.A4)

        dialog = QPrintPreviewDialog(printer, self)
        dialog.paintRequested.connect(self.print_preview)

        dialog.exec_()

    def print_preview(self, printer):
        self.document.setHtml(self.text_edit.toPlainText())

        self.document.print_(printer)

    def preview_document(self):
        printer = QPrinter()
        printer.setPageSize(QPrinter.A4)

        dialog = QPrintPreviewDialog(printer, self)
        dialog.paintRequested.connect(self.preview)

        dialog.exec_()

    def preview(self, printer):
        self.document.setHtml(self.text_edit.toPlainText())

        painter = QPainter(printer)
        painter.setRenderHint(QPainter.Antialiasing)
        self.document.drawContents(painter)
        painter.end()


if __name__ == "__main__":
    app = QApplication([])
    window = MainWindow()
    window.show()
    app.exec_()

在上述示例代码中，我们创建了一个窗口，并在窗口中添加了一个 QTextEdit 组件用于输入文本。接着我们创建了两个按钮，一个用于打印，一个用于打印预览。

在点击打印按钮时，我们会创建一个 QPrinter 对象，并通过 QPrintPreviewDialog 对象进行打印操作。而在点击打印预览按钮时，我们也是创建一个 QPrinter 对象，但是通过 QPrintPreviewDialog 对象进行打印预览操作。