QPrintDialog Class

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

Header: #include <QPrintDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
Inherits: 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 が真の場合、指定された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()も参照して ください。

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