이 페이지에서

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에서는 기본 인쇄 대화 상자가 사용되므로, 대화 상자에서 설정된 일부 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를 반환합니다.

options 및 setOption()도 참조하십시오 .

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