QPageLayout Class
페이지의 크기, 방향 및 여백을 설명합니다. 더 보기...
| 헤더: | #include <QPageLayout> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
공개 타입
| enum | Mode { StandardMode, FullPageMode } |
| enum | Orientation { Portrait, Landscape } |
(since 6.8) enum class | OutOfBoundsPolicy { Reject, Clamp } |
| enum | Unit { Millimeter, Point, Inch, Pica, Didot, Cicero } |
공개 함수
| QPageLayout() | |
| QPageLayout(const QPageSize &pageSize, QPageLayout::Orientation orientation, const QMarginsF &margins, QPageLayout::Unit units = Point, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0)) | |
| QPageLayout(const QPageLayout &other) | |
| ~QPageLayout() | |
| QRectF | fullRect() const |
| QRectF | fullRect(QPageLayout::Unit units) const |
| QRect | fullRectPixels(int resolution) const |
| QRect | fullRectPoints() const |
| bool | isEquivalentTo(const QPageLayout &other) const |
| bool | isValid() const |
| QMarginsF | margins() const |
| QMarginsF | margins(QPageLayout::Unit units) const |
| QMargins | marginsPixels(int resolution) const |
| QMargins | marginsPoints() const |
| QMarginsF | maximumMargins() const |
| QMarginsF | minimumMargins() const |
| QPageLayout::Mode | mode() const |
| QPageLayout::Orientation | orientation() const |
| QPageSize | pageSize() const |
| QRectF | paintRect() const |
| QRectF | paintRect(QPageLayout::Unit units) const |
| QRect | paintRectPixels(int resolution) const |
| QRect | paintRectPoints() const |
| bool | setBottomMargin(qreal bottomMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| bool | setLeftMargin(qreal leftMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| bool | setMargins(const QMarginsF &margins, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| void | setMinimumMargins(const QMarginsF &minMargins) |
| void | setMode(QPageLayout::Mode mode) |
| void | setOrientation(QPageLayout::Orientation orientation) |
| void | setPageSize(const QPageSize &pageSize, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0)) |
| bool | setRightMargin(qreal rightMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| bool | setTopMargin(qreal topMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject) |
| void | setUnits(QPageLayout::Unit units) |
| void | swap(QPageLayout &other) |
| QPageLayout::Unit | units() const |
| QPageLayout & | operator=(QPageLayout &&other) |
| QPageLayout & | operator=(const QPageLayout &other) |
관련 비멤버
| bool | operator!=(const QPageLayout &lhs, const QPageLayout &rhs) |
| bool | operator==(const QPageLayout &lhs, const QPageLayout &rhs) |
상세 설명
QPageLayout 클래스는 페이지 단위로 구성된 문서의 페이지 레이아웃을 정의하며, 페이지 크기, 방향 및 여백을 설정할 수 있고, 이러한 속성으로 정의된 전체 페이지 및 페인트 가능한 페이지 사각형을 다양한 단위로 조회할 수 있습니다.
페이지 크기는 QPageSize 클래스에 의해 정의되며, 이 클래스를 통해 페이지 크기 속성을 조회할 수 있습니다. QPageSize 자체는 항상 세로 방향으로 정의된다는 점에 유의하십시오.
레이아웃에 대해 최소 여백을 정의할 수 있지만, 일반적으로 기본값은 0입니다. Qt Print Support와 함께 사용할 경우, 최소 여백은 프린터에 의해 정의된 최소 인쇄 가능 영역을 반영합니다.
기본 StandardMode 에서는 현재 여백과 최소 여백이 항상 고려됩니다. 페인트 가능 사각형은 전체 페이지 사각형에서 현재 여백을 뺀 것이며, 현재 여백은 최소 여백과 전체 페이지 크기가 허용하는 최대 여백 사이의 값으로만 설정할 수 있습니다.
FullPageMode 에서는 현재 여백과 최소 여백이 고려되지 않습니다. 인쇄 가능 영역은 전체 페이지 영역이며, 현재 여백은 최소 여백 및 페이지 크기와 관계없이 어떤 값으로든 설정할 수 있습니다.
QPageSize도 참조하십시오 .
멤버 유형 문서
enum QPageLayout::Mode
페이지 레이아웃 모드를 정의합니다
| 상수 | 값 | 설명 |
|---|---|---|
QPageLayout::StandardMode | 0 | Paint Rect에는 여백이 포함되며, 여백은 최소값과 최대값 사이여야 합니다. |
QPageLayout::FullPageMode | 1 | Paint Rect는 여백을 포함하지 않으며, 여백은 임의의 값을 가질 수 있고 수동으로 관리해야 합니다. |
StandardMode에서 여백을 설정할 때는 ` Clamp `를 사용하여 여백이 허용되는 최소값과 최대값 사이로 자동으로 제한되도록 하십시오.
OutOfBoundsPolicy도 참조하십시오 .
enum QPageLayout::Orientation
이 열거형 유형은 페이지 방향을 정의합니다
| 상수 | 값 | 설명 |
|---|---|---|
QPageLayout::Portrait | 0 | 페이지 크기는 기본 방향에서 사용됩니다. |
QPageLayout::Landscape | 1 | 페이지 크기가 90도 회전됩니다 |
일부 표준 페이지 크기는 높이가 너비보다 작게 정의되어 있으므로, 방향은 상대적인 페이지 치수를 사용하는 것이 아니라 표준 페이지 크기를 기준으로 정의된다는 점에 유의하십시오.
[since 6.8] enum class QPageLayout::OutOfBoundsPolicy
경계 범위를 벗어난 여백에 대한 정책을 정의합니다
| 상수 | 값 | 설명 |
|---|---|---|
QPageLayout::OutOfBoundsPolicy::Reject | 0 | 여백은 최소값과 최대값 범위 내에 있어야 하며, 그렇지 않으면 거부됩니다. |
QPageLayout::OutOfBoundsPolicy::Clamp | 1 | 여백은 유효성을 보장하기 위해 최소값과 최대값 사이로 제한됩니다. 참고: 이 정책은 ‘ FullPageMode ’에서는 적용되지 않으며, 이 설정에서는 모든 마진이 허용됩니다. |
이 열거형은 Qt 6.8에서 도입되었습니다.
enum QPageLayout::Unit
이 열거형 유형은 페이지 레이아웃 및 여백의 측정 단위를 지정하는 데 사용됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPageLayout::Millimeter | 0 | |
QPageLayout::Point | 1 | 인치의 1/72 |
QPageLayout::Inch | 2 | |
QPageLayout::Pica | 3 | 1피트의 72분의 1, 1인치의 6분의 1, 12포인트 |
QPageLayout::Didot | 4 | 프랑스 인치의 1/72, 0.375 mm |
QPageLayout::Cicero | 5 | 프랑스 인치의 1/6, 12 디도, 4.5mm |
멤버 함수 문서
QPageLayout::QPageLayout()
유효하지 않은 QPageLayout을 생성합니다.
QPageLayout::QPageLayout(const QPageSize &pageSize, QPageLayout::Orientation orientation, const QMarginsF &margins, QPageLayout::Unit units = Point, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0))
지정된 pageSize, orientation 및 margins 를 사용하여, 지정된 units 내에 QPageLayout을 생성합니다.
선택적으로 허용되는 최소 여백 minMargins 을 정의할 수 있습니다. 예를 들어, 물리적 인쇄 장치에서 인쇄할 수 있는 최소 여백을 지정할 수 있습니다.
생성된 QPageLayout은 StandardMode 에 저장됩니다.
지정된 margins 값은 페이지 크기가 허용하는 최소 여백과 최대 여백 범위 내에서 제한됩니다.
QPageLayout::QPageLayout(const QPageLayout &other)
복사 생성자. ` other `를 `this`로 복사합니다.
[noexcept] QPageLayout::~QPageLayout()
페이지 레이아웃이 망가집니다.
QRectF QPageLayout::fullRect() const
현재 레이아웃 단위로 전체 페이지 사각형을 반환합니다.
이 페이지 사각형은 페이지 크기와 페이지 방향을 고려하지만, 페이지 여백은 고려하지 않습니다.
paintRect() 및 units()도 참조하십시오 .
QRectF QPageLayout::fullRect(QPageLayout::Unit units) const
지정된 페이지 사양( units)에 따른 전체 페이지 사각형을 반환합니다.
이 페이지 사각형은 페이지 크기와 페이지 방향을 반영하지만, 페이지 여백은 반영하지 않습니다.
paintRect()도 참조하십시오 .
QRect QPageLayout::fullRectPixels(int resolution) const
지정된 페이지 정보( resolution)에 대한 전체 페이지 사각형을 디바이스 픽셀 단위로 반환합니다.
이 페이지 사각형은 페이지 크기와 페이지 방향을 고려하지만, 페이지 여백은 고려하지 않습니다.
paintRect()도 참조하십시오 .
QRect QPageLayout::fullRectPoints() const
포스트스크립트 포인트(인치의 1/72) 단위로 전체 페이지 사각형을 반환합니다.
이 페이지 사각형은 페이지 크기와 페이지 방향을 반영하지만, 페이지 여백은 반영하지 않습니다.
paintRect()함수도 참조하십시오 .
bool QPageLayout::isEquivalentTo(const QPageLayout &other) const
이 페이지 레이아웃이 other 페이지 레이아웃과 동일할 경우, 즉 페이지의 크기, 여백 및 방향이 동일할 경우 true 를 반환합니다.
bool QPageLayout::isValid() const
이 페이지 레이아웃이 유효한 경우 true 을 반환합니다.
QMarginsF QPageLayout::margins() const
현재 설정된 단위를 사용하여 페이지 레이아웃의 여백을 반환합니다.
setMargins() 및 units()도 참조하십시오 .
QMarginsF QPageLayout::margins(QPageLayout::Unit units) const
요청된 ` units`를 사용하여 페이지 레이아웃의 여백을 반환합니다.
setMargins() 및 margins()도 참조하십시오 .
QMargins QPageLayout::marginsPixels(int resolution) const
지정된 페이지 레이아웃 resolution 의 여백을 디바이스 픽셀 단위로 반환합니다.
setMargins()도 참조하십시오 .
QMargins QPageLayout::marginsPoints() const
페이지 레이아웃의 여백을 포스트스크립트 포인트(1인치의 1/72) 단위로 반환합니다.
setMargins() 및 margins()도 참조하십시오 .
QMarginsF QPageLayout::maximumMargins() const
StandardMode 로 페이지 레이아웃이 설정된 경우 적용될 최대 여백을 반환합니다.
허용되는 최대 여백은 페이지 전체 크기에서 설정된 최소 여백을 뺀 값으로 계산됩니다. 예를 들어, 페이지 너비가 100포인트이고 최소 오른쪽 여백이 10포인트인 경우, 최대 왼쪽 여백은 90포인트가 됩니다.
setMinimumMargins() 및 minimumMargins()도 참조하십시오 .
QMarginsF QPageLayout::minimumMargins() const
페이지 레이아웃의 최소 여백을 반환합니다.
setMinimumMargins() 및 maximumMargins()도 참조하십시오 .
QPageLayout::Mode QPageLayout::mode() const
페이지 레이아웃 모드를 반환합니다.
setMode()도 참조하십시오 .
QPageLayout::Orientation QPageLayout::orientation() const
페이지 레이아웃의 페이지 방향을 반환합니다.
setOrientation()도 참조하십시오 .
QPageSize QPageLayout::pageSize() const
페이지 레이아웃의 페이지 크기를 반환합니다.
QPageSize 는 항상 세로 방향으로 정의된다는 점에 유의하십시오. 설정된 방향을 고려한 크기를 얻으려면 fullRect()를 사용해야 합니다.
setPageSize()도 참조하십시오 .
QRectF QPageLayout::paintRect() const
현재 레이아웃 단위로 표현된 페이지 직사각형을 반환합니다.
이 페인트 가능 영역은 페이지 크기, 방향 및 여백을 고려합니다.
FullPageMode 모드가 설정된 경우 fullRect()가 반환되며, 여백은 수동으로 관리해야 합니다.
QRectF QPageLayout::paintRect(QPageLayout::Unit units) const
지정된 ` units` 형식의 페이지 사각형을 반환합니다.
이 페인트 가능 영역은 페이지 크기, 방향 및 여백을 고려합니다.
FullPageMode 모드가 설정된 경우 fullRect()가 반환되며, 여백은 수동으로 관리해야 합니다.
QRect QPageLayout::paintRectPixels(int resolution) const
지정된 ` resolution`에 대해 둥근 모서리가 적용된 장치 픽셀 단위의 그리기 가능한 사각형을 반환합니다.
이 페인팅 가능 사각형은 페이지 크기, 방향 및 여백을 고려합니다.
FullPageMode 모드가 설정된 경우 fullRect()이 반환되며, 여백은 수동으로 관리해야 합니다.
QRect QPageLayout::paintRectPoints() const
둥근 포스트스크립트 포인트(1인치의 1/72) 단위로 칠할 수 있는 직사각형을 반환합니다.
이 채색 가능한 사각형은 페이지 크기, 방향 및 여백을 고려합니다.
FullPageMode 모드가 설정된 경우, fullRect()가 반환되며 여백은 수동으로 관리해야 합니다.
bool QPageLayout::setBottomMargin(qreal bottomMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
페이지 레이아웃의 하단 여백을 bottomMargin 로 설정합니다. 여백이 성공적으로 설정된 경우 true를 반환합니다.
사용되는 단위는 현재 레이아웃에 정의된 단위입니다. 다른 단위를 사용하려면 먼저 ` setUnits()`를 호출하십시오.
Qt 6.8부터, 선택적 매개변수 ` outOfBoundsPolicy `을 사용하여 범위를 벗어난 여백을 어떻게 처리할지 지정할 수 있습니다.
setMargins() 및 margins()도 참조하십시오 .
bool QPageLayout::setLeftMargin(qreal leftMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
페이지 레이아웃의 왼쪽 여백을 leftMargin 로 설정합니다. 여백이 성공적으로 설정되면 true를 반환합니다.
사용되는 단위는 현재 레이아웃에 정의된 단위입니다. 다른 단위를 사용하려면 먼저 ` setUnits()`를 호출하십시오.
Qt 6.8부터는 선택적 매개변수 ` outOfBoundsPolicy `을 사용하여 범위를 벗어난 여백을 어떻게 처리할지 지정할 수 있습니다.
setMargins() 및 margins()도 참조하십시오 .
bool QPageLayout::setMargins(const QMarginsF &margins, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
페이지 레이아웃의 여백을 margins 로 설정합니다. 여백이 성공적으로 설정되면 true를 반환합니다.
사용되는 단위는 현재 레이아웃에 정의된 단위입니다. 다른 단위를 사용하려면 먼저 ` setUnits()`를 호출하십시오.
Qt 6.8부터는 선택적 매개변수 ` outOfBoundsPolicy `를 사용하여 범위를 벗어난 여백을 어떻게 처리할지 지정할 수 있습니다.
void QPageLayout::setMinimumMargins(const QMarginsF &minMargins)
페이지 레이아웃의 최소 여백을 minMargins 로 설정합니다.
페이지 크기에 대해 설정된 기본값을 재정의하는 것은 권장되지 않습니다. 이는 물리적 인쇄 장치에서 인쇄 가능한 최소 영역일 수 있기 때문입니다.
StandardMode 모드가 설정된 경우, 기존 여백은 새로운 minMargins 값과 페이지 크기가 허용하는 최대값 사이로 제한됩니다. FullPageMode 가 설정된 경우, 기존 여백은 변경되지 않습니다.
minimumMargins() 및 setMargins()도 참조하십시오 .
void QPageLayout::setMode(QPageLayout::Mode mode)
페이지 레이아웃 모드를 ‘ mode ’로 설정합니다.
mode()도 참조하십시오 .
void QPageLayout::setOrientation(QPageLayout::Orientation orientation)
페이지 레이아웃의 페이지 방향을 ‘ orientation ’로 설정합니다.
방향 변경은 현재 여백이나 최소 여백에는 영향을 미치지 않습니다.
orientation()도 참조하십시오 .
void QPageLayout::setPageSize(const QPageSize &pageSize, const QMarginsF &minMargins = QMarginsF(0, 0, 0, 0))
페이지 레이아웃의 페이지 크기를 pageSize 로 설정합니다.
선택적으로 허용되는 최소 여백 minMargins 을 정의할 수 있습니다(예: 실제 인쇄 장치에서 인쇄할 수 있는 최소 여백). 이를 지정하지 않으면 최소 여백은 기본적으로 0으로 설정됩니다.
StandardMode 가 설정된 경우, 기존 여백은 새로운 최소 여백과 페이지 크기가 허용하는 최대 여백 범위 내에서 제한됩니다. FullPageMode 가 설정된 경우, 기존 여백은 변경되지 않습니다.
pageSize()도 참조하십시오 .
bool QPageLayout::setRightMargin(qreal rightMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
페이지 레이아웃의 오른쪽 여백을 rightMargin 로 설정합니다. 여백이 성공적으로 설정되면 true를 반환합니다.
사용되는 단위는 현재 레이아웃에 정의된 단위입니다. 다른 단위를 사용하려면 먼저 setUnits()를 호출하십시오.
Qt 6.8부터는 선택적 매개변수 ` outOfBoundsPolicy `을 사용하여 범위를 벗어난 여백을 어떻게 처리할지 지정할 수 있습니다.
setMargins() 및 margins()도 참조하십시오 .
bool QPageLayout::setTopMargin(qreal topMargin, QPageLayout::OutOfBoundsPolicy outOfBoundsPolicy = OutOfBoundsPolicy::Reject)
페이지 레이아웃의 상단 여백을 topMargin 로 설정합니다. 여백이 성공적으로 설정되면 true를 반환합니다.
사용되는 단위는 현재 레이아웃에 정의된 단위입니다. 다른 단위를 사용하려면 먼저 ` setUnits()`를 호출하십시오.
Qt 6.8부터는 선택적 매개변수 ` outOfBoundsPolicy `을 사용하여 범위를 벗어난 여백을 어떻게 처리할지 지정할 수 있습니다.
setMargins() 및 margins()도 참조하십시오 .
void QPageLayout::setUnits(QPageLayout::Unit units)
페이지 레이아웃을 정의하는 데 사용되는 ` units `을 설정합니다.
units()도 참조하십시오 .
[noexcept] void QPageLayout::swap(QPageLayout &other)
이 페이지 레이아웃을 other 로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.
QPageLayout::Unit QPageLayout::units() const
페이지 레이아웃이 현재 어떤 단위로 정의되어 있는지 반환합니다.
setUnits()도 참조하십시오 .
[noexcept] QPageLayout &QPageLayout::operator=(QPageLayout &&other)
other 를 이 QPageLayout 인스턴스에 이동 할당하여, 관리되는 포인터의 소유권을 이 인스턴스로 이전합니다.
QPageLayout &QPageLayout::operator=(const QPageLayout &other)
할당 연산자는 ` other `을 `this`에 할당합니다.
관련 비멤버
bool operator!=(const QPageLayout &lhs, const QPageLayout &rhs)
페이지 레이아웃 lhs 이 페이지 레이아웃 rhs 과 같지 않은 경우, 즉 속성 중 하나라도 다른 경우 true 를 반환합니다.
이는 엄격한 등가 비교임을 유의하십시오. 특히 페이지 크기의 경우 QPageSize 의 ID, 이름 및 크기가 정확히 일치해야 하며, 여백의 경우 단위가 일치해야 합니다.
QPageLayout::isEquivalentTo()도 참조하십시오 .
bool operator==(const QPageLayout &lhs, const QPageLayout &rhs)
페이지 레이아웃 lhs 이 페이지 레이아웃 rhs 과 동일한 경우, 즉 모든 속성이 정확히 일치하는 경우 true 을 반환합니다.
이는 엄격한 동일성을 의미하며, 특히 페이지 크기의 경우 QPageSize 의 ID, 이름 및 크기가 정확히 일치해야 하고, 여백의 경우 단위가 일치해야 한다는 점에 유의하십시오.
QPageLayout::isEquivalentTo()도 참조하십시오 .
© 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.