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 개체가 인쇄용으로 올바르게 구성된 것입니다.

프린터 대화 상자(위 플라스티크 스타일로 표시됨)를 통해 일반적인 인쇄 속성에 액세스할 수 있습니다. CUPS 인쇄 시스템을 사용하는 X11 플랫폼에서는 대화 상자의 Properties 푸시 버튼을 통해 사용 가능한 각 프린터의 설정을 수정할 수 있습니다.

Windows 및 macOS에서는 기본 인쇄 대화 상자가 사용되므로 대화 상자에 설정된 일부 QWidgetQDialog 속성이 존중되지 않습니다. macOS의 기본 인쇄 대화 상자는 프린터 옵션 설정을 지원하지 않으므로 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 을 지웁니다.

optionstestOption()도 참조하세요 .

[override virtual] void QPrintDialog::setVisible(bool visible)

다시 구현합니다: QDialog::setVisible(bool 표시).

bool QPrintDialog::testOption(QAbstractPrintDialog::PrintDialogOption option) const

지정된 option 이 활성화된 경우 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

optionssetOption()도 참조하세요 .

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