Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QPrintPreviewDialog Class

QPrintPreviewDialog 클래스는 프린터 출력을 위한 페이지 레이아웃을 미리 보고 구성할 수 있는 대화 상자를 제공합니다. 더 보기...

헤더: #include <QPrintPreviewDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport
상속: QDialog

공개 함수

QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual ~QPrintPreviewDialog()
void open(QObject *receiver, const char *member)
QPrinter *printer()

재구현된 공용 함수

virtual void done(int result) override
virtual void setVisible(bool visible) override

신호

void paintRequested(QPrinter *printer)

상세 설명

기존 애플리케이션에서 QPrintPreviewDialog를 사용하는 방법은 간단합니다:

  1. QPrintPreviewDialog를 생성합니다.

    기존의 ` QPrinter ` 객체를 사용하여 `QPrintPreviewDialog`를 생성하거나, `QPrintPreviewDialog`가 시스템 기본 프린터를 사용하여 직접 생성하도록 할 수 있습니다.

  2. paintRequested() 신호를 슬롯에 연결합니다.

    대화 상자가 미리보기 페이지 세트를 생성해야 할 때 paintRequested() 신호가 발송됩니다. 미리보기 생성과 실제 인쇄에는 완전히 동일한 코드를 사용할 수 있으며, 여기에는 미리보기에서 새 페이지를 시작하기 위해 QPrinter::newPage()를 호출하는 것도 포함됩니다. paintRequested() 신호에 슬롯을 연결하고, 해당 슬롯으로 전달된 QPrinter 객체에 그림을 그립니다.

  3. exec()를 호출하세요.

    QPrintPreviewDialog::exec()를 호출하여 미리보기 대화 상자를 표시합니다.

QPrinter, QPrintDialog, QPageSetupDialog 및 QPrintPreviewWidget도 참조하십시오 .

멤버 함수 문서

[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

printer 을 기반으로 하며, 부모 위젯으로 parent 을 사용하는 QPrintPreviewDialog를 생성합니다. 위젯 플래그 flags 는 QWidget 생성자에 전달됩니다.

QWidget::setWindowFlags()도 참조하십시오 .

[explicit] QPrintPreviewDialog::QPrintPreviewDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

이렇게 하면 시스템 기본 프린터를 사용하는 내부 ` QPrinter ` 객체가 생성됩니다.

이것은 오버로드된 함수입니다.

[virtual noexcept] QPrintPreviewDialog::~QPrintPreviewDialog()

QPrintPreviewDialog 를 삭제합니다.

[override virtual] void QPrintPreviewDialog::done(int result)

QDialog::done(int r)을 재구현합니다.

void QPrintPreviewDialog::open(QObject *receiver, const char *member)

대화 상자를 열고, finished(int) 신호를 receiver 및 member 에서 지정한 슬롯에 연결합니다.

대화 상자가 닫히면 해당 신호는 슬롯에서 분리됩니다.

[signal] void QPrintPreviewDialog::paintRequested(QPrinter *printer)

이 신호는 QPrintPreviewDialog 가 미리보기 페이지 세트를 생성해야 할 때 발생합니다.

제공된 ` printer ` 인스턴스는 각 페이지의 내용을 그릴 페인트 장치이며, 직접 인쇄할 때와 동일한 방식으로 ` QPrinter ` 인스턴스를 사용하여 해당 장치에 내용을 그려야 합니다.

QPrinter *QPrintPreviewDialog::printer()

이 대화 상자가 현재 처리 중인 ` QPrinter ` 객체에 대한 포인터를 반환합니다.

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

QDialog::setVisible(bool visible)을 재구현합니다.

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