이 페이지에서

QPrintPreviewWidget Class

QPrintPreviewWidget 클래스는 프린터 출력용 페이지 레이아웃을 미리 볼 수 있는 위젯을 제공합니다. 더 보기...

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

공개 유형

enum ViewMode { SinglePageView, FacingPagesView, AllPagesView }
enum ZoomMode { CustomZoom, FitToWidth, FitInView }

공개 함수

QPrintPreviewWidget(QPrinter *printer, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QPrintPreviewWidget(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual ~QPrintPreviewWidget()
int currentPage() const
QPageLayout::Orientation orientation() const
int pageCount() const
QPrintPreviewWidget::ViewMode viewMode() const
qreal zoomFactor() const
QPrintPreviewWidget::ZoomMode zoomMode() const

재구현된 공용 함수

virtual void setVisible(bool visible) override

공개 슬롯

void fitInView()
void fitToWidth()
void print()
void setAllPagesViewMode()
void setCurrentPage(int page)
void setFacingPagesViewMode()
void setLandscapeOrientation()
void setOrientation(QPageLayout::Orientation orientation)
void setPortraitOrientation()
void setSinglePageViewMode()
void setViewMode(QPrintPreviewWidget::ViewMode mode)
void setZoomFactor(qreal factor)
void setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)
void updatePreview()
void zoomIn(qreal factor = 1.1)
void zoomOut(qreal factor = 1.1)

신호

void paintRequested(QPrinter *printer)
void previewChanged()

상세 설명

QPrintPreviewDialog 는 내부적으로 QPrintPreviewWidget을 사용하며, QPrintPreviewWidget의 목적은 미리보기를 다른 위젯에 삽입할 수 있도록 하는 것입니다. 또한 이를 통해 QPrintPreviewDialog 에서 제공하는 기본 사용자 인터페이스와는 다른 사용자 인터페이스를 구축할 수 있게 해줍니다.

QPrintPreviewWidget의 사용법은 간단합니다:

  1. QPrintPreviewWidget 생성

    기존의 ` QPrinter ` 객체를 전달하여 `QPrintPreviewWidget`을 생성하거나, `QPrintPreviewWidget`이 기본 생성된 ` QPrinter ` 객체를 대신 생성하도록 할 수 있습니다.

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

    위젯이 미리보기 페이지 세트를 생성해야 할 때, 위젯에서 ` paintRequested()` 신호가 발생합니다. 이 신호에 슬롯을 연결하고, 신호 매개변수로 전달된 ` QPrinter `에 그림을 그립니다. 미리보기에서 새 페이지를 시작하려면 ` QPrinter::newPage()`를 호출합니다.

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

멤버 유형 문서

enum QPrintPreviewWidget::ViewMode

이 열거형은 미리보기 위젯의 보기 모드를 설명하는 데 사용됩니다.

상수값설명
QPrintPreviewWidget::SinglePageView0미리 보기에서 단일 페이지를 보는 모드입니다.
QPrintPreviewWidget::FacingPagesView1미리보기의 대면 페이지가 표시되는 모드입니다.
QPrintPreviewWidget::AllPagesView2미리보기의 모든 페이지를 볼 수 있는 보기 모드입니다.

enum QPrintPreviewWidget::ZoomMode

이 열거형은 미리보기 위젯의 확대/축소 모드를 설명하는 데 사용됩니다.

상수값설명
QPrintPreviewWidget::CustomZoom0확대/축소 비율이 사용자 지정 값으로 설정됩니다.
QPrintPreviewWidget::FitToWidth1이 모드는 현재 페이지를 뷰의 너비에 맞게 조정합니다.
QPrintPreviewWidget::FitInView2이 모드는 현재 페이지를 뷰 안에 맞춥니다.

멤버 함수 문서

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

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

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

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

이로 인해 QPrintPreviewWidget은 미리보기를 생성하는 데 사용될 내부 기본 생성된 QPrinter 객체를 생성하게 됩니다.

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

[virtual noexcept] QPrintPreviewWidget::~QPrintPreviewWidget()

QPrintPreviewWidget 을 파괴합니다.

int QPrintPreviewWidget::currentPage() const

미리보기에서 현재 보고 있는 페이지를 반환합니다.

setCurrentPage()도 참조하십시오 .

[slot] void QPrintPreviewWidget::fitInView()

이 함수는 편의 함수이며, ` setZoomMode(QPrintPreviewWidget::FitInView)`를 호출하는 것과 동일합니다.

[slot] void QPrintPreviewWidget::fitToWidth()

이 함수는 편의 함수이며, ` setZoomMode(QPrintPreviewWidget::FitToWidth)`를 호출하는 것과 동일합니다.

QPageLayout::Orientation QPrintPreviewWidget::orientation() const

미리보기의 현재 방향을 반환합니다. 이 값은 미리보기와 연결된 QPrinter 객체에서 가져옵니다.

setOrientation()도 참조하십시오 .

int QPrintPreviewWidget::pageCount() const

미리보기의 페이지 수를 반환합니다.

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

이 신호는 미리보기 위젯이 미리보기 페이지 세트를 생성해야 할 때 발생합니다. ` printer `는 이 미리보기 위젯과 연결된 프린터입니다.

[signal] void QPrintPreviewWidget::previewChanged()

이 신호는 미리보기 위젯의 방향과 같은 내부 상태가 변경될 때마다 발생합니다.

[slot] void QPrintPreviewWidget::print()

미리보기와 연결된 프린터로 미리보기 내용을 인쇄합니다.

[slot] void QPrintPreviewWidget::setAllPagesViewMode()

이 함수는 편의 함수이며, ` setViewMode(QPrintPreviewWidget::AllPagesView)`을 호출하는 것과 동일합니다.

[slot] void QPrintPreviewWidget::setCurrentPage(int page)

미리보기에서 현재 페이지를 설정합니다. 이 작업을 수행하면 보기가 page 의 맨 앞으로 이동합니다.

currentPage()도 참조하십시오 .

[slot] void QPrintPreviewWidget::setFacingPagesViewMode()

이 함수는 편의 함수이며, ` setViewMode(QPrintPreviewWidget::FacingPagesView)`를 호출하는 것과 동일합니다.

[slot] void QPrintPreviewWidget::setLandscapeOrientation()

이 함수는 편의 함수이며, ` setOrientation(QPageLayout::Landscape)`를 호출하는 것과 동일합니다.

[slot] void QPrintPreviewWidget::setOrientation(QPageLayout::Orientation orientation)

현재 방향을 ` orientation`로 설정합니다. 이 값은 미리보기와 연결된 ` QPrinter ` 객체에 적용됩니다.

orientation()도 참조하십시오 .

[slot] void QPrintPreviewWidget::setPortraitOrientation()

이 함수는 편의 함수이며, ` setOrientation(QPageLayout::Portrait)`를 호출하는 것과 동일합니다.

[slot] void QPrintPreviewWidget::setSinglePageViewMode()

이것은 편의 함수이며, ` setViewMode(QPrintPreviewWidget::SinglePageView)`를 호출하는 것과 동일합니다.

[slot] void QPrintPreviewWidget::setViewMode(QPrintPreviewWidget::ViewMode mode)

뷰 모드를 ‘ mode ’로 설정합니다. 기본 뷰 모드는 ‘ SinglePageView ’입니다.

viewMode()도 참조하십시오 .

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

[slot] void QPrintPreviewWidget::setZoomFactor(qreal factor)

뷰의 확대/축소 배율을 factor 로 설정합니다. 예를 들어, 값이 1.0이면 확대/축소되지 않은 뷰를 의미하며, 이는 뷰가 종이에 출력될 때의 크기와 거의 같습니다. 값이 0.5이면 뷰의 크기가 절반으로 줄어들고, 값이 2.0이면 뷰의 크기가 두 배로 늘어납니다.

zoomFactor()도 참조하십시오 .

[slot] void QPrintPreviewWidget::setZoomMode(QPrintPreviewWidget::ZoomMode zoomMode)

줌 모드를 zoomMode 로 설정합니다. 기본 줌 모드는 FitInView 입니다.

zoomMode(), viewMode(), setViewMode()도 참조하십시오 .

[slot] void QPrintPreviewWidget::updatePreview()

이 함수는 미리보기를 업데이트하며, 이로 인해 paintRequested() 신호가 발생합니다.

QPrintPreviewWidget::ViewMode QPrintPreviewWidget::viewMode() const

현재 보기 모드를 반환합니다. 기본 보기 모드는 SinglePageView 입니다.

setViewMode()도 참조하십시오 .

qreal QPrintPreviewWidget::zoomFactor() const

뷰의 확대/축소 비율을 반환합니다.

setZoomFactor()도 참조하십시오 .

[slot] void QPrintPreviewWidget::zoomIn(qreal factor = 1.1)

현재 보기를 factor 만큼 확대합니다. factor 의 기본값은 1.1이며, 이는 보기가 10% 확대된다는 것을 의미합니다.

QPrintPreviewWidget::ZoomMode QPrintPreviewWidget::zoomMode() const

현재 확대/축소 모드를 반환합니다.

setZoomMode(), viewMode(), setViewMode()도 참조하십시오 .

[slot] void QPrintPreviewWidget::zoomOut(qreal factor = 1.1)

현재 보기를 ` factor`만큼 축소합니다. ` factor `의 기본값은 1.1이며, 이는 보기가 10% 축소됨을 의미합니다.

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