QPrintPreviewWidget Class
QPrintPreviewWidget 클래스는 프린터 출력용 페이지 레이아웃을 미리 볼 수 있는 위젯을 제공합니다. 더 보기...
| 헤더: | #include <QPrintPreviewWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| 상속: | QWidget |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QPrintPreviewWidget은 프린터 및 인쇄 API의 일부입니다.
공개 유형
| 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의 사용법은 간단합니다:
- QPrintPreviewWidget 생성
기존의 ` QPrinter ` 객체를 전달하여 `QPrintPreviewWidget`을 생성하거나, `QPrintPreviewWidget`이 기본 생성된 ` QPrinter ` 객체를 대신 생성하도록 할 수 있습니다.
- paintRequested() 신호를 슬롯에 연결합니다.
위젯이 미리보기 페이지 세트를 생성해야 할 때, 위젯에서 ` paintRequested()` 신호가 발생합니다. 이 신호에 슬롯을 연결하고, 신호 매개변수로 전달된 ` QPrinter `에 그림을 그립니다. 미리보기에서 새 페이지를 시작하려면 ` QPrinter::newPage()`를 호출합니다.
QPrinter, QPrintDialog, QPageSetupDialog 및 QPrintPreviewDialog도 참조하십시오 .
멤버 유형 문서
enum QPrintPreviewWidget::ViewMode
이 열거형은 미리보기 위젯의 보기 모드를 설명하는 데 사용됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | 미리 보기에서 단일 페이지를 보는 모드입니다. |
QPrintPreviewWidget::FacingPagesView | 1 | 미리보기의 대면 페이지가 표시되는 모드입니다. |
QPrintPreviewWidget::AllPagesView | 2 | 미리보기의 모든 페이지를 볼 수 있는 보기 모드입니다. |
enum QPrintPreviewWidget::ZoomMode
이 열거형은 미리보기 위젯의 확대/축소 모드를 설명하는 데 사용됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPrintPreviewWidget::CustomZoom | 0 | 확대/축소 비율이 사용자 지정 값으로 설정됩니다. |
QPrintPreviewWidget::FitToWidth | 1 | 이 모드는 현재 페이지를 뷰의 너비에 맞게 조정합니다. |
QPrintPreviewWidget::FitInView | 2 | 이 모드는 현재 페이지를 뷰 안에 맞춥니다. |
멤버 함수 문서
[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.