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의 인쇄 지원과 함께 사용할 경우 최소 여백은 프린터에서 정의한 최소 인쇄 가능 영역을 반영합니다.
기본값 StandardMode 에서는 항상 현재 여백과 최소 여백이 고려됩니다. 인쇄 가능한 직사각형은 전체 페이지 사각형에서 현재 여백을 뺀 값이며, 현재 여백은 전체 페이지 크기에서 허용하는 최소 여백과 최대 여백 사이의 값으로만 설정할 수 있습니다.
FullPageMode 에서는 현재 여백과 최소 여백이 고려되지 않습니다. 칠할 수 있는 사각형은 전체 페이지 사각형이며 현재 여백은 최소 여백 및 페이지 크기와 관계없이 모든 값으로 설정할 수 있습니다.
QPageSize 을참조하세요 .
회원 유형 문서
enum QPageLayout::Mode
페이지 레이아웃 모드를 정의합니다.
상수 | 값 | 설명 |
---|---|---|
QPageLayout::StandardMode | 0 | 페인트 사각형은 여백을 포함하며, 여백은 최소값과 최대값 사이에 있어야 합니다. |
QPageLayout::FullPageMode | 1 | 페인트 직사각형은 여백을 제외하며, 여백은 임의의 값으로 설정할 수 있으며 수동으로 관리해야 합니다. |
표준 모드에서 여백을 설정할 때 Clamp 을 사용하여 여백이 최소값과 최대 허용 값 사이에 있도록 여백을 자동으로 고정합니다.
OutOfBoundsPolicy 를참조하세요 .
enum QPageLayout::Orientation
이 열거형 유형은 페이지 방향을 정의합니다.
상수 | 값 | 설명 |
---|---|---|
QPageLayout::Portrait | 0 | 페이지 크기가 기본 방향으로 사용됩니다. |
QPageLayout::Landscape | 1 | 페이지 크기가 90도 회전됩니다. |
일부 표준 페이지 크기는 너비가 높이보다 큰 것으로 정의되므로 방향은 상대 페이지 치수를 사용하지 않고 표준 페이지 크기를 기준으로 정의됩니다.
[since 6.8]
enum class QPageLayout::OutOfBoundsPolicy
범위를 벗어난 여백에 대한 정책을 정의합니다.
Constant | 값 | 설명 |
---|---|---|
QPageLayout::OutOfBoundsPolicy::Reject | 0 | 여백은 최소값과 최대값 내에 있어야 하며, 그렇지 않으면 거부됩니다. |
QPageLayout::OutOfBoundsPolicy::Clamp | 1 | 여백이 유효한지 확인하기 위해 최소값과 최대값 사이에 여백이 고정됩니다. |
참고: 이 정책은 모든 여백이 허용되는 FullPageMode 에서는 적용되지 않습니다.
이 열거형은 Qt 6.8에 도입되었습니다.
enum QPageLayout::Unit
이 열거형 유형은 페이지 레이아웃 및 여백의 측정 단위를 지정하는 데 사용됩니다.
Constant | 값 | 설명 |
---|---|---|
QPageLayout::Millimeter | 0 | |
QPageLayout::Point | 1 | 1/72인치 |
QPageLayout::Inch | 2 | |
QPageLayout::Pica | 3 | 1/72피트, 1/6인치, 12포인트 |
QPageLayout::Didot | 4 | 1/72인치, 프렌치 인치, 0.375mm |
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))
주어진 units 에 주어진 pageSize, orientation 및 margins 를 사용하여 QPageLayout을 만듭니다.
선택적으로 허용되는 최소 여백을 정의합니다 minMargins, 예를 들어 실제 인쇄 장치에서 인쇄할 수 있는 최소 여백을 정의합니다.
구성된 QPageLayout은 StandardMode 에 있습니다.
주어진 margins 은 페이지 크기에서 허용되는 최소 여백과 최대 여백으로 고정됩니다.
QPageLayout::QPageLayout(const QPageLayout &other)
생성자 복사, other 을 여기로 복사합니다.
[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/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/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 을 할당합니다.
관련 비회원
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()도 참조하세요 .
© 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.