Back to Qt.io
Contact Us Blog Download Qt

QPrintPreviewDialog Class

QPrintPreviewDialogクラスは、プリンタ出力用のページレイアウトをプレビューし、設定するためのダイアログを提供します。詳細...

ヘッダ #include <QPrintPreviewDialog>
CMake： find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake： QT += printsupport
継承： QDialog

パブリック関数

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を使用するのは簡単です：

  1. QPrintPreviewDialogを作成します。

    QPrintPreviewDialogは、既存のQPrinter オブジェクトで作成することもできますし、QPrintPreviewDialogに作成させることもできます。

  2. paintRequested() シグナルをスロットに接続します。

    ダイアログがプレビューページのセットを生成する必要がある場合、paintRequested() シグナルが発行されます。QPrinter::newPage （）を呼び出してプレビューの新しいページを開始するなど、プレビューを生成するのとまったく同じコードを実際の印刷に使用できます。paintRequested() シグナルにスロットを接続し、スロットに渡されたQPrinter オブジェクトに描画します。

  3. exec() を呼び出す。

    QPrintPreviewDialog::exec() を呼び出して、プレビュー・ダイアログを表示する。

QPrinter 、QPrintDialog 、QPageSetupDialog 、QPrintPreviewWidgetも参照 。

メンバー関数ドキュメント

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

printer 、parent を親ウィジェットとして QPrintPreviewDialog を構築します。ウィジェットフラグflags はQWidget コンストラクタに渡されます。

QWidget::setWindowFlags()も参照してください 。

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

これはオーバーロードされた関数です。

これは内部のQPrinter オブジェクトを作成し、システムのデフォルト・プリンタを使用します。

[virtual noexcept] QPrintPreviewDialog::~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.