QPrintDialog Class

QPrintDialogクラスは、プリンタの設定を指定するためのダイアログを提供します。詳細...

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

プロパティ

パブリック関数

QPrintDialog(QWidget *parent = nullptr)
QPrintDialog(QPrinter *printer, QWidget *parent = nullptr)
virtual ~QPrintDialog()
void open(QObject *receiver, const char *member)
QAbstractPrintDialog::PrintDialogOptions options() const
QPrinter *printer()
void setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true)
void setOptions(QAbstractPrintDialog::PrintDialogOptions options)
bool testOption(QAbstractPrintDialog::PrintDialogOption option) const

再実装パブリック関数

virtual void done(int result) override
virtual int exec() override
virtual void setVisible(bool visible) override

シグナル

void accepted(QPrinter *printer)

詳細説明

このダイアログでは、用紙サイズや向き、印刷の種類(カラーまたはグレースケール)、ページ数、印刷部数など、ドキュメント関連の設定を変更することができます。

また、設定されたネットワークプリンターを含む、利用可能なプリンターからユーザーが選択できるようにするためのコントロールも提供されます。

通常、QPrintDialogオブジェクトはQPrinter オブジェクトで構築され、exec ()関数を使用して実行されます。

QPrintDialog printDialog(printer, parent);
if (printDialog.exec() == QDialog::Accepted) {
    // print ...
}

ダイアログがユーザーに受け入れられた場合、QPrinter オブジェクトは印刷用に正しく設定されます。

プリンターダイアログ(上図はPlastiqueスタイル)は、一般的な印刷プロパティへのアクセスを可能にします。CUPS印刷システムを使用するX11プラットフォームでは、利用可能な各プリンターの設定は、ダイアログのProperties プッシュボタンで変更できます。

WindowsとmacOSでは、ネイティブ印刷ダイアログが使用されます。これは、ダイアログで設定されたQWidgetQDialog プロパティの一部が尊重されないことを意味します。つまり、setOptions() とsetOption() は何の効果もありません。

Qt 4.4 では、macOS 上で静的関数を使用してシートを表示することができました。これは Qt 4.5 ではサポートされなくなりました。この機能が必要な場合は、QPrintDialog::open() を使用してください。

QPageSetupDialogQPrinterも参照して ください。

プロパティのドキュメント

options : PrintDialogOptions

このプロパティは、ダイアログのルック&フィールに影響を与える様々なオプションを保持します。

デフォルトでは、すべてのオプションは無効になっています。

オプションはダイアログを表示する前に設定する必要があります。ダイアログが表示されている間にオプションを設定しても、ダイアログに即座に反映されるとは限りません(オプションやプラットフォームによって異なります)。

アクセス関数:

QAbstractPrintDialog::PrintDialogOptions options() const
void setOptions(QAbstractPrintDialog::PrintDialogOptions options)

setOption() およびtestOption()も参照

メンバ関数ドキュメント

[explicit] QPrintDialog::QPrintDialog(QWidget *parent = nullptr)

与えられたparent で印刷ダイアログを構築します。

[explicit] QPrintDialog::QPrintDialog(QPrinter *printer, QWidget *parent = nullptr)

与えられたparent で、与えられたprinter のための新しいモーダルプリンタダイアログを構築します。

[virtual noexcept] QPrintDialog::~QPrintDialog()

印刷ダイアログを破棄する。

[signal] void QPrintDialog::accepted(QPrinter *printer)

このシグナルは、ユーザーが印刷ダイアログで設定された値を受け入れたときに発行される。printer パラメータには、設定が適用されたプリンタが含まれます。

[override virtual] void QPrintDialog::done(int result)

再インプリメント:QDialog::done(int r)。

ダイアログを閉じ、その結果コードをresult に設定する。 このダイアログがexec() で表示されている場合、done() によってローカルイベントループが終了し、exec() がresult を返す。

注: この関数は、Mac macOSおよびWindowsプラットフォームのネイティブ・プリント・ダイアログには適用されません。なぜなら、このダイアログはモーダルである必要があり、ユーザーだけが閉じることができるからです。

QDialog::done()も参照してください

[override virtual] int QPrintDialog::exec()

再インプリメント:QDialog::exec().

void QPrintDialog::open(QObject *receiver, const char *member)

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

ダイアログを開き、そのaccepted() シグナルをreceivermember で指定されたスロットに接続します。

ダイアログが閉じられると、シグナルはスロットから切り離されます。

QPrinter *QPrintDialog::printer()

このプリンタ・ダイアログが操作するプリンタを返します。これはQPrintDialog::open() メソッドを使用する際に便利です。

void QPrintDialog::setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true)

on が true の場合、与えられたoption を有効にする。そうでない場合、与えられたoption をクリアする。

options およびtestOption()も参照のこと

[override virtual] void QPrintDialog::setVisible(bool visible)

再インプリメント:QDialog::setVisible(bool visible).

bool QPrintDialog::testOption(QAbstractPrintDialog::PrintDialogOption option) const

与えられたoption が有効であればtrue を返し、そうでなければ false を返す。

options およびsetOption()も参照

© 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.