QPageLayoutクラス、QPrinterクラス、QPrintPreviewDialogクラスを使いこなす

QPagedPaintDevice::pageLayout() 関数の詳細解説

概要

QPagedPaintDevice は、複数のページで構成されるドキュメントを描画するための基底クラスです。pageLayout() 関数は、このクラスによって提供され、以下の情報を設定および取得するために使用されます。

• ページサイズ: 各ページの幅と高さ
• ページ余白: 各ページの周囲の空白領域
• 向き: 縦方向または横方向
• ページ番号: 各ページの一意の識別番号

使用方法

pageLayout() 関数は、以下の2つの異なる方法で呼び出すことができます。

1. 現在のページレイアウト設定を取得する:

QPageSize pageSize = pagedPaintDevice->pageLayout().pageSize();
Qt::Orientation orientation = pagedPaintDevice->pageLayout().orientation();

1. 新しいページレイアウト設定を設定する:

QPageSize pageSize(width, height);
QPageLayout pageLayout(pageSize, orientation);
pagedPaintDevice->setPageLayout(pageLayout);

引数と戻り値

pageLayout() 関数は、以下の引数と戻り値を持ちます。

• 引数:
• 戻り値:

関連クラスと関数

• QPageSize: ページサイズを表すクラス
• QPageLayout: ページレイアウト設定を表すクラス
• QPrinter: 印刷機能を提供するクラス
• QPrintPreviewDialog: 印刷プレビュー機能を提供するクラス

以下のサンプルコードは、pageLayout() 関数を使用して、2つのページを持つドキュメントを作成し、印刷する方法を示します。

#include <QGuiApplication>
#include <QPdfWriter>
#include <QPagedPaintDevice>
#include <QPainter>

int main(int argc, char **argv) {
  QGuiApplication app(argc, argv);

  // ページサイズと向きを設定
  QPageSize pageSize(595, 842); // A4サイズ
  Qt::Orientation orientation = Qt::Portrait;

  // QPagedPaintDevice オブジェクトを作成
  QPagedPaintDevice *pagedPaintDevice = new QPagedPaintDevice;
  pagedPaintDevice->setPageSize(pageSize);
  pagedPaintDevice->setPageLayout(QPageLayout(pageSize, orientation));

  // 各ページに描画
  QPainter painter(pagedPaintDevice);
  for (int i = 0; i < 2; ++i) {
    painter.begin(pagedPaintDevice->page(i));
    painter.drawText(10, 10, QString("ページ %1").arg(i + 1));
    painter.end();
  }

  // PDF ファイルに書き出す
  QPdfWriter writer("output.pdf");
  writer.setPageSize(pageSize);
  writer.setPageLayout(QPageLayout(pageSize, orientation));
  writer.setCreator("Qt Example");

  QPainter painter(&writer);
  for (int i = 0; i < pagedPaintDevice->pageCount(); ++i) {
    painter.begin(writer.page(i));
    painter.drawPixmap(0, 0, pagedPaintDevice->page(i).toImage());
    painter.end();
  }

  writer.close();

  return 0;
}

補足

• pageLayout() 関数は、Qt GUI 5.15 以降で使用可能です。

QPagedPaintDevice::pageLayout() 関数を使ったサンプルコード

#include <QGuiApplication>
#include <QPdfWriter>
#include <QPagedPaintDevice>
#include <QPainter>

int main(int argc, char **argv) {
  QGuiApplication app(argc, argv);

  // ページサイズと向きを設定
  QPageSize pageSizeA4(595, 842); // A4サイズ
  QPageSize pageSizeLetter(612, 792); // レターサイズ
  Qt::Orientation orientation = Qt::Portrait;

  // QPagedPaintDevice オブジェクトを作成
  QPagedPaintDevice *pagedPaintDevice = new QPagedPaintDevice;

  // ページ1: A4サイズ
  pagedPaintDevice->addPage(pageSizeA4);
  QPainter painterA4(pagedPaintDevice->page(0));
  painterA4.drawText(10, 10, "ページ 1 (A4)");

  // ページ2: レターサイズ
  pagedPaintDevice->addPage(pageSizeLetter);
  QPainter painterLetter(pagedPaintDevice->page(1));
  painterLetter.drawText(10, 10, "ページ 2 (レター)");

  // PDF ファイルに書き出す
  QPdfWriter writer("output.pdf");
  writer.setPageSize(pageSizeA4); // 最初のページサイズに合わせる
  writer.setPageLayout(QPageLayout(pageSizeA4, orientation));
  writer.setCreator("Qt Example");

  QPainter painter(&writer);
  for (int i = 0; i < pagedPaintDevice->pageCount(); ++i) {
    painter.begin(writer.page(i));
    painter.drawPixmap(0, 0, pagedPaintDevice->page(i).toImage());
    painter.end();
  }

  writer.close();

  return 0;
}

ヘッダーとフッターを含むドキュメント

#include <QGuiApplication>
#include <QPdfWriter>
#include <QPagedPaintDevice>
#include <QPainter>
#include <QFont>

int main(int argc, char **argv) {
  QGuiApplication app(argc, argv);

  // ページサイズと向きを設定
  QPageSize pageSize(595, 842); // A4サイズ
  Qt::Orientation orientation = Qt::Portrait;

  // QPagedPaintDevice オブジェクトを作成
  QPagedPaintDevice *pagedPaintDevice = new QPagedPaintDevice;
  pagedPaintDevice->setPageSize(pageSize);
  pagedPaintDevice->setPageLayout(QPageLayout(pageSize, orientation));

  // ヘッダーとフッターを描画する関数
  void drawHeaderFooter(QPainter &painter, int pageNumber) {
    painter.save();

    // ヘッダー
    painter.setFont(QFont("Arial", 12));
    painter.drawText(10, 10, QString("ドキュメントタイトル"));

    // フッター
    painter.setPen(Qt::gray);
    painter.drawText(QRectF(0, pagedPaintDevice->height() - 20, pagedPaintDevice->width(), 20), Qt::AlignRight, QString("ページ %1").arg(pageNumber));

    painter.restore();
  }

QPagedPaintDevice::pageLayout() 関数以外の方法

QPageLayout クラスは、ページサイズ、向き、余白などのページレイアウト設定をカプセル化するクラスです。このクラスを使用して、以下の操作を行うことができます。

• ページサイズと向きを設定
• 余白を設定
• ヘッダーとフッターを設定
• 印刷時に使用するページレイアウトを取得

QPrinter クラスは、印刷機能を提供するクラスです。このクラスを使用して、以下の操作を行うことができます。

• 印刷を実行

QPrintPreviewDialog クラスは、印刷プレビュー機能を提供するクラスです。このクラスを使用して、以下の操作を行うことができます。

• 印刷プレビューを表示
• 印刷設定を変更

以下のサンプルコードは、QPageLayout クラスを使用して、ページレイアウト設定を管理する方法を示します。

#include <QGuiApplication>
#include <QPdfWriter>
#include <QPagedPaintDevice>
#include <QPainter>
#include <QPageLayout>

int main(int argc, char **argv) {
  QGuiApplication app(argc, argv);

  // ページサイズと向きを設定
  QPageSize pageSize(595, 842); // A4サイズ
  Qt::Orientation orientation = Qt::Portrait;

  // QPageLayout オブジェクトを作成
  QPageLayout pageLayout(pageSize, orientation);
  pageLayout.setMargins(10, 10, 10, 10); // 余白を設定

  // QPagedPaintDevice オブジェクトを作成
  QPagedPaintDevice *pagedPaintDevice = new QPagedPaintDevice;
  pagedPaintDevice->setPageSize(pageSize);
  pagedPaintDevice->setPageLayout(pageLayout);

  // 各ページに描画
  QPainter painter(pagedPaintDevice);
  for (int i = 0; i < pagedPaintDevice->pageCount(); ++i) {
    painter.begin(pagedPaintDevice->page(i));
    painter.drawText(100, 100, QString("ページ %1").arg(i + 1));
    painter.end();
  }

  // PDF ファイルに書き出す
  QPdfWriter writer("output.pdf");
  writer.setPageSize(pageSize);
  writer.setPageLayout(pageLayout);
  writer.setCreator("Qt Example");

  QPainter painter(&writer);
  for (int i = 0; i < pagedPaintDevice->pageCount(); ++i) {
    painter.begin(writer.page(i));
    painter.drawPixmap(0, 0, pagedPaintDevice->page(i).toImage());
    painter.end();
  }

  writer.close();

  return 0;
}