QPrintPreviewDialog Class
QPrintPreviewDialog クラスは、プリンタ出力用のページレイアウトをプレビューおよび設定するためのダイアログを提供します。詳細...
| ヘッダー: | #include <QPrintPreviewDialog> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| 継承元: | QDialog |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QPrintPreviewDialogは、「標準ダイアログ」および「プリンタおよび印刷API」の一部です。
パブリック関数
| 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 を使用するのは簡単です:
- QPrintPreviewDialog を作成します。
既存のQPrinter オブジェクトを使用してQPrintPreviewDialogを構築することも、QPrintPreviewDialogに自動的に作成させることもできます。後者の場合、システムのデフォルトプリンタが使用されます。
- paintRequested() シグナルをスロットに接続します。
ダイアログがプレビューページを生成する必要がある場合、paintRequested() シグナルが発火します。プレビューの生成時と実際の印刷時では、まったく同じコードを使用できます。これには、プレビューで新しいページを開始するためのQPrinter::newPage() の呼び出しも含まれます。paintRequested() シグナルにスロットを接続し、そのスロットに渡されるQPrinter オブジェクト上に描画を行います。
- 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）を再実装しています。
© 2026 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.
