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はStandard DialogsおよびPrinter and Printing APIsの一部です。
プロパティ
- 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 が真の場合、指定された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 を返す。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。