Back to Qt.io
Contact Us Blog Download Qt

QPrintPreviewDialog Class

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

Header: #include <QPrintPreviewDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
Inherits: 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)を再実装します。

このドキュメントに含まれるコントリビューションの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。