Qt 使用打印机详解

Qt 使用打印机详解

• [一、Qt 使用打印机详解](#一、Qt 使用打印机详解)
• • 1、概述
  • 2、步骤详解
  • • [步骤 1: 创建和初始化 QPrinter 对象](#步骤 1: 创建和初始化 QPrinter 对象)
    • [步骤 2: 配置打印机设置](#步骤 2: 配置打印机设置)
    • [步骤 3: 使用 QPainter 绘制内容](#步骤 3: 使用 QPainter 绘制内容)
    • [步骤 4: 执行打印](#步骤 4: 执行打印)
    • 可选步骤：打印预览
  • 3、完整代码示例
  • 4、注意事项
• 二、示例
• • 1、效果展示
  • 2、源码分享

一、Qt 使用打印机详解

在 Qt6 框架中，打印功能主要通过 QPrinter 类实现，它允许开发者将应用程序的内容输出到打印机或 PDF 文件。Qt6 的打印机制基于绘图系统，使用 QPainter 来绘制要打印的内容。以下是详细的使用方法，分步解释并提供代码示例。所有步骤基于 Qt6 的官方文档和最佳实践。

1、概述

Qt6 中的打印过程涉及以下核心类：

• QPrinter: 管理打印机设置，如页面大小、方向、分辨率等。
• QPainter: 用于绘制文本、图形等内容到打印设备。
• QPrintDialog: 提供打印对话框，让用户选择打印机和设置（可选）。
• QPageSetupDialog: 设置页面属性（可选）。
• QPrintPreviewDialog: 预览打印内容（可选）。

打印流程一般包括：初始化打印机、配置设置、绘制内容、执行打印。Qt6 兼容 Qt5 的打印 API，但建议使用 Qt6 的新特性（如更高效的资源管理）。

2、步骤详解

步骤 1: 创建和初始化 QPrinter 对象

首先，你需要创建一个 QPrinter 对象来代表打印机。可以选择默认打印机或指定设置。

• 关键方法：
  • 使用默认设置：QPrinter printer;
  • 设置输出模式：例如，输出到 PDF 文件。
  • 设置页面大小和方向：如 A4 纸、横向或纵向。

示例初始化：

QPrinter printer(QPrinter::HighResolution); // 高分辨率打印
printer.setPageSize(QPageSize::A4); // 设置页面大小为 A4
printer.setPageOrientation(QPageLayout::Landscape); // 设置为横向
printer.setOutputFileName("output.pdf"); // 可选：输出到 PDF 文件

步骤 2: 配置打印机设置

通过对话框或直接代码设置打印机属性，以提高用户体验。

• 使用 QPrintDialog：让用户选择打印机和设置。
• 使用 QPageSetupDialog：设置页面布局。
• 直接设置：在代码中指定属性，如分辨率、颜色模式等。

示例使用对话框：

QPrintDialog printDialog(&printer, this); // this 指向父窗口
if (printDialog.exec() == QDialog::Accepted) {
    // 用户确认设置，继续打印
} else {
    // 用户取消，处理错误
}

步骤 3: 使用 QPainter 绘制内容

QPainter 用于在打印机上绘制文本、图形或自定义内容。你需要在一个绘制上下文中操作。

• 关键步骤：
  • 创建 QPainter 对象，关联到 QPrinter。
  • 使用 QPainter 的方法绘制内容，如 drawText()、drawRect() 等。
  • 处理页面布局：例如，计算坐标以适应页面大小。

示例绘制简单文本：

QPainter painter;
if (!painter.begin(&printer)) { // 关联到打印机
    qDebug() << "无法启动打印";
    return;
}

// 绘制文本
painter.drawText(100, 100, "Hello, Qt6 Printing!"); // 坐标单位为点（1/72 英寸）
// 绘制图形
painter.drawRect(50, 50, 200, 100); // 矩形

painter.end(); // 结束绘制

步骤 4: 执行打印

一旦内容绘制完成，调用 QPrinter 的方法执行打印。如果设置了输出文件，会保存到文件。

• 自动执行：QPainter::end() 会触发打印操作。
• 手动控制：可以使用 QPrinter::newPage() 处理多页文档。

示例多页打印：

QPainter painter(&printer);
for (int i = 0; i < 3; ++i) {
    painter.drawText(100, 100, QString("Page %1").arg(i+1));
    if (i < 2) {
        printer.newPage(); // 切换到新页
    }
}
painter.end();

可选步骤：打印预览

使用 QPrintPreviewDialog 预览打印内容，确保布局正确。

• 创建预览对话框，并连接信号处理绘制。
• 示例代码：

QPrintPreviewDialog previewDialog(&printer, this);
QObject::connect(&previewDialog, &QPrintPreviewDialog::paintRequested, [&](QPrinter *previewPrinter) {
    QPainter painter(previewPrinter);
    painter.drawText(100, 100, "Preview Content");
});
previewDialog.exec(); // 显示预览

3、完整代码示例

以下是一个简单的 Qt6 应用程序示例，演示打印文本。假设在 QMainWindow 的上下文中。

#include <QMainWindow>
#include <QPrinter>
#include <QPainter>
#include <QPrintDialog>
#include <QDebug>

void MainWindow::printDocument() {
    // 步骤 1: 创建 QPrinter
    QPrinter printer(QPrinter::HighResolution);
    printer.setPageSize(QPageSize::A4);
    printer.setPageOrientation(QPageLayout::Portrait);

    // 步骤 2: 显示打印对话框
    QPrintDialog printDialog(&printer, this);
    if (printDialog.exec() != QDialog::Accepted) {
        qDebug() << "打印取消";
        return;
    }

    // 步骤 3: 使用 QPainter 绘制内容
    QPainter painter;
    if (!painter.begin(&printer)) {
        qDebug() << "无法启动打印机";
        return;
    }

    // 绘制简单内容
    painter.setFont(QFont("Arial", 12));
    painter.drawText(100, 100, "Qt6 打印机测试示例");
    painter.drawRect(50, 150, 200, 100); // 矩形

    // 结束绘制，触发打印
    painter.end();
    qDebug() << "打印成功";
}

4、注意事项

• Qt6 变化 ：Qt6 中，QPrinter 类保持兼容，但推荐使用 Qt6 的新模块如 QtPrintSupport。确保在项目文件中添加 QT += printsupport。
• 常见问题 ：
  • 坐标系统：QPainter 使用点（point）单位，1 点 = 1/72 英寸。确保内容适应页面大小。
  • 分辨率：高分辨率设置可能影响性能，测试时使用默认值。
  • 错误处理：检查 QPainter::begin() 的返回值，处理打印机不可用情况。
  • 多平台：Qt6 打印支持 Windows、macOS 和 Linux，但行为可能因系统而异。
• 最佳实践 ：
  • 使用预览功能调试布局。
  • 对于复杂文档，考虑使用 QTextDocument 和 QTextDocument::print() 简化文本打印。
  • 参考 Qt6 官方文档：QPrinter Class。

二、示例

1、效果展示

2、源码分享

• mainWindow.h

  #ifndef MAINWINDOW_H
  #define MAINWINDOW_H
  
  #include <QMainWindow>
  #include <QPrinter>
  #include <QPrintDialog>
  #include <QPainter>
  
  QT_BEGIN_NAMESPACE
  namespace Ui {
  class MainWindow;
  }
  QT_END_NAMESPACE
  
  class MainWindow : public QMainWindow
  {
      Q_OBJECT
  
  public:
      MainWindow(QWidget *parent = nullptr);
      ~MainWindow();
      void printDocument();
  private slots:
      void on_pushButton_clicked();
  
  private:
      Ui::MainWindow *ui;
  };
  #endif // MAINWINDOW_H

• mainWindow.cpp

  #include "mainwindow.h"
  #include "ui_mainwindow.h"
  
  MainWindow::MainWindow(QWidget *parent)
      : QMainWindow(parent)
      , ui(new Ui::MainWindow)
  {
      ui->setupUi(this);
  }
  
  MainWindow::~MainWindow()
  {
      delete ui;
  }
  
  void MainWindow::printDocument()
  {
      // 创建打印机对象
      QPrinter printer(QPrinter::HighResolution);
  
      // 显示打印对话框
      QPrintDialog printDialog(&printer, this);
      if (printDialog.exec() != QDialog::Accepted)
          return;
  
      // 创建绘图对象
      QPainter painter;
      painter.begin(&printer);
  
      // 设置字体
      QFont font = painter.font();
      font.setPointSize(20);
      painter.setFont(font);
  
      // 打印文本
      painter.drawText(100, 100, "Qt6 打印示例");
  
      // 绘制简单图形
      painter.drawRect(50, 150, 200, 100);
      painter.drawEllipse(100, 300, 100, 100);
  
      // 结束打印
      painter.end();
  
  }
  
  void MainWindow::on_pushButton_clicked()
  {
      this->printDocument();
  }