QPrintDialog Class
QPrintDialogクラスは、プリンタの設定を指定するためのダイアログを提供します。詳細...
ヘッダー | #include <QPrintDialog> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
qmake: | QT += printsupport |
継承: | QAbstractPrintDialog |
- 継承メンバを含む全メンバのリスト
- QPrintDialogは、Standard DialogsおよびPrinter and Printing APIの一部です。
プロパティ
- options : PrintDialogOptions
パブリック関数
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では、ネイティブ印刷ダイアログが使用されます。これは、ダイアログで設定されたQWidget とQDialog プロパティの一部が尊重されないことを意味します。つまり、setOptions() とsetOption() は何の効果もありません。
Qt 4.4 では、macOS 上で静的関数を使用してシートを表示することができました。これは Qt 4.5 ではサポートされなくなりました。この機能が必要な場合は、QPrintDialog::open() を使用してください。
QPageSetupDialog とQPrinterも参照して ください。
プロパティのドキュメント
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() シグナルをreceiver とmember で指定されたスロットに接続します。
ダイアログが閉じられると、シグナルはスロットから切り離されます。
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 を返す。
© 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.