QPrintDialog Class
QPrintDialog クラスは、プリンタの設定を指定するためのダイアログを提供します。詳細...
| ヘッダー: | #include <QPrintDialog> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| 継承元: | QAbstractPrintDialog |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QPrintDialogは、「標準ダイアログ」および「プリンタおよび印刷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 のプロパティの一部は反映されません。macOSのネイティブ印刷ダイアログはプリンタオプションの設定をサポートしていないため、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)
指定されたprinter に対して、指定されたparent を使用して、新しいモーダルなプリンタダイアログを作成します。
[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を返します。
© 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.

