QPrintPreviewWidget Class
QPrintPreviewWidget 클래스는 프린터 출력용 페이지 레이아웃을 미리 볼 수 있는 위젯을 제공합니다. 더 보기...
Header: | #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 는 내부적으로 QPrintPreview 위젯을 사용하며, QPrintPreview 위젯의 목적은 다른 위젯에 미리보기를 포함할 수 있도록 하는 것입니다. 또한 QPrintPreviewDialog 에서 제공하는 기본 사용자 인터페이스와 다른 사용자 인터페이스를 구축할 수 있습니다.
QPrintPreviewWidget 사용법은 간단합니다:
- QPrintPreviewWidget을 생성합니다.
기존 QPrinter 객체를 전달하여 QPrintPreviewWidget을 생성하거나, QPrintPreviewWidget이 기본으로 생성된 QPrinter 객체를 생성하도록 합니다.
- paintRequested() 신호를 슬롯에 연결합니다.
위젯이 미리보기 페이지 세트를 생성해야 할 때 위젯에서 paintRequested() 신호가 방출됩니다. 이 신호에 슬롯을 연결하고 신호 매개변수로 전달된 QPrinter 에 그림을 그립니다. QPrinter::newPage ()를 호출하여 미리보기에서 새 페이지를 시작합니다.
QPrinter, QPrintDialog, QPageSetupDialog, QPrintPreviewDialog 을참조하세요 .
멤버 유형 문서
enum QPrintPreviewWidget::ViewMode
이 열거형은 미리보기 위젯의 보기 모드를 설명하는 데 사용됩니다.
Constant | 값 | 설명 |
---|---|---|
QPrintPreviewWidget::SinglePageView | 0 | 미리보기에서 단일 페이지를 보는 모드입니다. |
QPrintPreviewWidget::FacingPagesView | 1 | 미리보기의 마주보는 페이지가 표시되는 모드입니다. |
QPrintPreviewWidget::AllPagesView | 2 | 미리 보기의 모든 페이지를 보는 모드입니다. |
enum QPrintPreviewWidget::ZoomMode
이 열거형은 미리보기 위젯의 확대/축소 모드를 설명하는 데 사용됩니다.
Constant | 값 | 설명 |
---|---|---|
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% 축소됨을 의미합니다.
© 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.