QPrintPreviewWidget Class

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

Header: #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 는 내부적으로 QPrintPreview 위젯을 사용하며, QPrintPreview 위젯의 목적은 다른 위젯에 미리보기를 포함할 수 있도록 하는 것입니다. 또한 QPrintPreviewDialog 에서 제공하는 기본 사용자 인터페이스와 다른 사용자 인터페이스를 구축할 수 있습니다.

QPrintPreviewWidget 사용법은 간단합니다:

  1. QPrintPreviewWidget을 생성합니다.

    기존 QPrinter 객체를 전달하여 QPrintPreviewWidget을 생성하거나, QPrintPreviewWidget이 기본으로 생성된 QPrinter 객체를 생성하도록 합니다.

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

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

QPrinter, QPrintDialog, QPageSetupDialog, QPrintPreviewDialog참조하세요 .

멤버 유형 문서

enum QPrintPreviewWidget::ViewMode

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

Constant설명
QPrintPreviewWidget::SinglePageView0미리보기에서 단일 페이지를 보는 모드입니다.
QPrintPreviewWidget::FacingPagesView1미리보기의 마주보는 페이지가 표시되는 모드입니다.
QPrintPreviewWidget::AllPagesView2미리 보기의 모든 페이지를 보는 모드입니다.

enum QPrintPreviewWidget::ZoomMode

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

Constant설명
QPrintPreviewWidget::CustomZoom0줌이 사용자 지정 줌 값으로 설정됩니다.
QPrintPreviewWidget::FitToWidth1이 모드는 현재 페이지를 뷰 너비에 맞춥니다.
QPrintPreviewWidget::FitInView2이 모드는 뷰 내부의 현재 페이지에 맞춥니다.

멤버 함수 문서

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

printer 을 기반으로 하고 parent 을 부모 위젯으로 하여 QPrintPreviewWidget을 생성합니다. 위젯 플래그 flagsQWidget 생성자에게 전달됩니다.

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% 축소됨을 의미합니다.

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