Back to Qt.io
Contact Us Blog Download Qt

QPrintPreviewDialog Class

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

Header: #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)

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

대화 상자를 열고 완성(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 표시).

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