이 페이지에서

QPagedPaintDevice Class

QPagedPaintDevice 클래스는 여러 페이지를 지원하는 페인트 장치를 나타냅니다. 더 보기...

헤더: #include <QPagedPaintDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
상속: QPaintDevice
상속받는 항목:

QPdfWriter 그리고 QPrinter

공개 유형

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_40PDF 1.4 호환 문서가 생성됩니다.
QPagedPaintDevice::PdfVersion_A1b1PDF/A-1b 호환 문서가 생성됩니다.
QPagedPaintDevice::PdfVersion_1_62Qt PDF 1.6 호환 문서가 생성됩니다. 이 값은 Qt 5.12에서 추가되었습니다.
QPagedPaintDevice::PdfVersion_X4 (since Qt 6.8)3PDF/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 ’를 설정합니다.

페이지 방향은 페이지 사각형(page rect)을 가져올 때 페이지 크기의 방향을 정의하는 데 사용됩니다.

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 로 성공적으로 설정된 경우 true를 반환합니다.

pageLayout()도 참조하십시오 .

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