QPagedPaintDevice Class
QPagedPaintDevice 클래스는 여러 페이지를 지원하는 페인트 장치를 나타냅니다. 더 보기...
Header: | #include <QPagedPaintDevice> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
상속합니다: | QPaintDevice |
상속 대상 |
- 상속된 멤버를 포함한 모든 멤버 목록
- QPagedPaintDevice는 페인팅 클래스의 일부입니다.
공용 유형
enum | PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6, PdfVersion_X4 } |
공용 함수
virtual | ~QPagedPaintDevice() |
virtual bool | newPage() = 0 |
QPageLayout | pageLayout() const |
(since 6.0) QPageRanges | pageRanges() const |
virtual bool | setPageLayout(const QPageLayout &newPageLayout) |
virtual bool | setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter) |
virtual bool | setPageOrientation(QPageLayout::Orientation orientation) |
(since 6.0) virtual void | setPageRanges(const QPageRanges &ranges) |
virtual bool | setPageSize(const QPageSize &pageSize) |
상세 설명
페이징 페인트 장치는 인쇄용 또는 PDF와 같은 형식의 출력을 생성하는 데 사용됩니다. QPdfWriter 와 QPrinter 는 이를 상속합니다.
멤버 유형 문서
enum QPagedPaintDevice::PdfVersion
PdfVersion 열거형은 QPrinter 또는 QPdfWriter 에서 생성한 PDF 파일의 버전을 설명합니다.
상수 | 값 | 설명 |
---|---|---|
QPagedPaintDevice::PdfVersion_1_4 | 0 | PDF 1.4 호환 문서가 생성됩니다. |
QPagedPaintDevice::PdfVersion_A1b | 1 | PDF/A-1b 호환 문서가 생성됩니다. |
QPagedPaintDevice::PdfVersion_1_6 | 2 | PDF 1.6 호환 문서가 생성됩니다. 이 값은 Qt 5.12에서 추가되었습니다. |
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8) | 3 | PDF/X-4 호환 문서가 생성됩니다. |
멤버 기능 문서
[virtual noexcept]
QPagedPaintDevice::~QPagedPaintDevice()
개체를 파괴합니다.
[pure virtual]
bool QPagedPaintDevice::newPage()
새 페이지를 시작합니다. 성공 시 true
을 반환합니다.
QPageLayout QPagedPaintDevice::pageLayout() const
현재 페이지 레이아웃을 반환합니다. 이 메서드를 사용하여 현재 QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() 및 paintRect()에 액세스할 수 있습니다.
반환된 객체에서 설정자를 사용할 수 없으며 개별 QPagedPaintDevice 설정자를 호출하거나 setPageLayout()를 사용해야 합니다.
setPageLayout(), setPageSize(), setPageOrientation() 및 setPageMargins()도 참조하세요 .
[since 6.0]
QPageRanges QPagedPaintDevice::pageRanges() const
이 장치와 연관된 페이지 범위를 반환합니다.
이 함수는 Qt 6.0에 도입되었습니다.
setPageRanges(), QPageRanges, QPrinter::fromPage() 및 QPrinter::toPage()도 참조하세요 .
[virtual]
bool QPagedPaintDevice::setPageLayout(const QPageLayout &newPageLayout)
페이지 레이아웃을 newPageLayout 으로 설정합니다.
QPainter::begin()를 호출하기 전 또는 newPage()를 호출하기 바로 전에 호출하여 새 페이지 레이아웃을 새 페이지에 적용해야 합니다. 잘못된 페인트 메트릭이 사용될 수 있으므로 setPageLayout() 호출과 newPage() 호출 사이에 페인트 메서드를 호출해서는 안 됩니다.
페이지 레이아웃이 newPageLayout 로 성공적으로 설정되면 true를 반환합니다.
pageLayout()도 참조하세요 .
[virtual]
bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units = QPageLayout::Millimeter)
주어진 units 에 정의된 margins 페이지를 설정합니다.
QPainter::begin() 호출 전 또는 newPage() 호출 직전에 호출하여 새 페이지에 새 여백을 적용해야 합니다. 잘못된 페인트 메트릭이 사용될 수 있으므로 setPageMargins() 호출과 newPage() 호출 사이에 페인트 메서드를 호출해서는 안 됩니다.
현재 페이지 여백을 가져오려면 pageLayout().margins()를 사용합니다.
페이지 여백이 margins 로 성공적으로 설정되면 true를 반환합니다.
pageLayout()도 참조하세요 .
[virtual]
bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)
페이지를 설정합니다 orientation.
페이지 방향은 페이지 정방향을 가져올 때 페이지 크기의 방향을 정의하는 데 사용됩니다.
새 페이지에 새 방향을 적용하려면 QPainter::begin()를 호출하기 전 또는 newPage()를 호출하기 직전에 이 메서드를 호출해야 합니다. 잘못된 페인트 메트릭이 사용될 수 있으므로 setPageOrientation() 호출과 newPage() 호출 사이에 페인트 메서드를 호출해서는 안 됩니다.
현재 QPageLayout::Orientation 를 가져오려면 pageLayout().orientation()을 사용합니다.
페이지 방향이 orientation 로 성공적으로 설정되면 true를 반환합니다.
pageLayout()도 참조하세요 .
[virtual, since 6.0]
void QPagedPaintDevice::setPageRanges(const QPageRanges &ranges)
이 장치의 페이지 범위를 ranges 로 설정합니다.
이 함수는 Qt 6.0에 도입되었습니다.
pageRanges()도 참조하십시오 .
[virtual]
bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)
페이지 크기를 pageSize 로 설정합니다.
현재 QPageSize 를 가져오려면 pageLayout().pageSize()를 사용합니다.
새 페이지에 새 페이지 크기를 적용하려면 QPainter::begin() 호출 전 또는 newPage() 호출 직전에 이 메서드를 호출해야 합니다. 잘못된 페인트 메트릭이 사용될 수 있으므로 setPageSize() 호출과 newPage() 호출 사이에 페인트 메서드를 호출해서는 안 됩니다.
페이지 크기가 pageSize 로 성공적으로 설정되면 참을 반환합니다.
pageLayout()도 참조하세요 .
© 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.