QPageSize Class

QPageSize 클래스는 정의된 페이지 크기의 크기와 이름을 설명합니다. 더 보기...

Header: #include <QPageSize>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

공용 타입

enum PageSizeId { A0, A1, A2, A3, A4, …, LastPageSize }
enum SizeMatchPolicy { FuzzyMatch, FuzzyOrientationMatch, ExactMatch }
enum Unit { Millimeter, Point, Inch, Pica, Didot, Cicero }

공용 함수

QPageSize()
QPageSize(QPageSize::PageSizeId pageSize)
QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize(const QPageSize &other)
~QPageSize()
QSizeF definitionSize() const
QPageSize::Unit definitionUnits() const
QPageSize::PageSizeId id() const
bool isEquivalentTo(const QPageSize &other) const
bool isValid() const
QString key() const
QString name() const
QRectF rect(QPageSize::Unit units) const
QRect rectPixels(int resolution) const
QRect rectPoints() const
QSizeF size(QPageSize::Unit units) const
QSize sizePixels(int resolution) const
QSize sizePoints() const
void swap(QPageSize &other)
int windowsId() const
QPageSize &operator=(QPageSize &&other)
QPageSize &operator=(const QPageSize &other)

정적 공용 멤버

QSizeF definitionSize(QPageSize::PageSizeId pageSizeId)
QPageSize::Unit definitionUnits(QPageSize::PageSizeId pageSizeId)
QPageSize::PageSizeId id(int windowsId)
QPageSize::PageSizeId id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QPageSize::PageSizeId id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)
QString key(QPageSize::PageSizeId pageSizeId)
QString name(QPageSize::PageSizeId pageSizeId)
QSizeF size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)
QSize sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)
QSize sizePoints(QPageSize::PageSizeId pageSizeId)
int windowsId(QPageSize::PageSizeId pageSizeId)
bool operator!=(const QPageSize &lhs, const QPageSize &rhs)
bool operator==(const QPageSize &lhs, const QPageSize &rhs)

상세 설명

이 클래스는 Adobe Postscript PPD 표준 v4.3에 정의된 표준 페이지 크기 집합에 대한 지원을 구현합니다. 표준 페이지 크기 집합을 포인트, 밀리미터 및 인치로 정의하고 이러한 크기가 일관되게 사용되도록 합니다. 다른 크기 단위를 사용할 수 있지만 계산된 결과이므로 항상 일관되지 않을 수 있습니다. 정의된 포인트 크기는 항상 정수이며, 다른 모든 크기는 단위의 분수일 수 있습니다.

정의된 크기는 암시된 페이지 방향 없이 항상 너비 x 높이 순서로 표시됩니다. QPageSize::Ledger 과 같이 너비가 높이보다 큰 페이지 크기를 정의할 수 있으므로 너비와 높이 값을 비교하여 페이지 방향을 결정할 수 없습니다.

예를 들어 A4는 표준에 따라 210mm x 297mm, 8.27인치 x 11.69인치 또는 595pt x 842pt로 정의됩니다.

원하는 단위로 사용자 지정 이름을 사용하여 사용자 지정 페이지 크기를 정의할 수도 있으며 이 단위 크기는 유지되어 다른 모든 단위 크기 계산의 기준으로 사용됩니다.

사용자 지정 QSize 을 사용하여 QPageSize를 만들 때 표준 페이지 크기와 크기를 일치시킬지 여부를 선택할 수 있습니다. 기본적으로 QPaperSize는 지정된 페이지 크기가 정의된 표준 크기의 포스트스크립트 3포인트 이내인 경우 표준 페이지 크기에 일치시키는 FuzzyMatch 모드를 사용합니다. 이를 재정의하여 정확한 일치만 요청할 수 있지만 단위 간 변환으로 인해 3포인트가 손실되어 페이지 크기가 잘못될 수 있으므로 권장하지 않습니다.

인쇄 장치에 지원되는 페이지 크기를 쿼리하여 QPageSize 인스턴스를 얻을 수도 있습니다. 이 경우 반환되는 지역화된 이름은 프린터 자체에서 정의한 이름입니다. 인쇄 장치가 현재 기본 로캘 언어를 지원하지 않을 수 있습니다.

이 클래스는 페이지 크기 ID를 다양한 단위 크기로 변환하는 편리한 메서드도 제공합니다.

QPagedPaintDeviceQPdfWriter참조하세요 .

멤버 유형 문서

enum QPageSize::PageSizeId

이 열거형 유형은 Postscript PPD 표준에 정의된 대로 사용 가능한 페이지 크기를 나열합니다. 이러한 값은 QPagedPaintDeviceQPrinter 에 중복되어 있습니다.

정의된 크기는 다음과 같습니다:

Constant설명
QPageSize::A03841 x 1189 mm
QPageSize::A14594 x 841 mm
QPageSize::A25420 x 594 mm
QPageSize::A36297 x 420 mm
QPageSize::A47210 x 297mm, 8.26 x 11.69인치
QPageSize::A58148 x 210mm
QPageSize::A69105 x 148mm
QPageSize::A71074 x 105mm
QPageSize::A81152 x 74mm
QPageSize::A91237 x 52mm
QPageSize::B0141000 x 1414 mm
QPageSize::B115707 x 1000 mm
QPageSize::B216500 x 707 mm
QPageSize::B317353 x 500mm
QPageSize::B418250 x 353mm
QPageSize::B519176 x 250mm, 6.93 x 9.84인치
QPageSize::B620125 x 176 mm
QPageSize::B72188 x 125mm
QPageSize::B82262 x 88mm
QPageSize::B92344 x 62mm
QPageSize::B102431 x 44mm
QPageSize::C5E25163 x 229mm
QPageSize::Comm10E26105 x 241mm, 미국 일반 10 봉투
QPageSize::DLE27110 x 220mm
QPageSize::Executive27.5 x 10인치, 190.5 x 254mm
QPageSize::Folio28210 x 330mm
QPageSize::Ledger29431.8 x 279.4 mm
QPageSize::Legal18.5 x 14인치, 215.9 x 355.6mm
QPageSize::Letter08.5 x 11인치, 215.9 x 279.4mm
QPageSize::Tabloid30279.4 x 431.8mm
QPageSize::Custom31알 수 없음 또는 사용자 정의 크기.
QPageSize::A1013
QPageSize::A3Extra32
QPageSize::A4Extra33
QPageSize::A4Plus34
QPageSize::A4Small35
QPageSize::A5Extra36
QPageSize::B5Extra37
QPageSize::JisB038
QPageSize::JisB139
QPageSize::JisB240
QPageSize::JisB341
QPageSize::JisB442
QPageSize::JisB543
QPageSize::JisB644,
QPageSize::JisB745
QPageSize::JisB846
QPageSize::JisB947
QPageSize::JisB1048
QPageSize::AnsiALetter= 문자
QPageSize::AnsiBLedger= 원장
QPageSize::AnsiC49
QPageSize::AnsiD50
QPageSize::AnsiE51
QPageSize::LegalExtra52
QPageSize::LetterExtra53
QPageSize::LetterPlus54
QPageSize::LetterSmall55
QPageSize::TabloidExtra56
QPageSize::ArchA57
QPageSize::ArchB58
QPageSize::ArchC59
QPageSize::ArchD60
QPageSize::ArchE61
QPageSize::Imperial7x962
QPageSize::Imperial8x1063
QPageSize::Imperial9x1164
QPageSize::Imperial9x1265
QPageSize::Imperial10x1166
QPageSize::Imperial10x1367
QPageSize::Imperial10x1468
QPageSize::Imperial12x1169
QPageSize::Imperial15x1170
QPageSize::ExecutiveStandard71
QPageSize::Note72
QPageSize::Quarto73
QPageSize::Statement74
QPageSize::SuperA75
QPageSize::SuperB76
QPageSize::Postcard77
QPageSize::DoublePostcard78
QPageSize::Prc16K79
QPageSize::Prc32K80
QPageSize::Prc32KBig81
QPageSize::FanFoldUS82
QPageSize::FanFoldGerman83
QPageSize::FanFoldGermanLegal84
QPageSize::EnvelopeB485
QPageSize::EnvelopeB586
QPageSize::EnvelopeB687
QPageSize::EnvelopeC088
QPageSize::EnvelopeC189
QPageSize::EnvelopeC290
QPageSize::EnvelopeC391
QPageSize::EnvelopeC492
QPageSize::EnvelopeC5C5E= C5E
QPageSize::EnvelopeC693
QPageSize::EnvelopeC6594
QPageSize::EnvelopeC795
QPageSize::EnvelopeDLDLE= DLE
QPageSize::Envelope996
QPageSize::Envelope10Comm10E= Comm10E
QPageSize::Envelope1197
QPageSize::Envelope1298
QPageSize::Envelope1499
QPageSize::EnvelopeMonarch100
QPageSize::EnvelopePersonal101
QPageSize::EnvelopeChou3102
QPageSize::EnvelopeChou4103
QPageSize::EnvelopeInvite104
QPageSize::EnvelopeItalian105
QPageSize::EnvelopeKaku2106
QPageSize::EnvelopeKaku3107
QPageSize::EnvelopePrc1108
QPageSize::EnvelopePrc2109
QPageSize::EnvelopePrc3110
QPageSize::EnvelopePrc4111
QPageSize::EnvelopePrc5112
QPageSize::EnvelopePrc6113
QPageSize::EnvelopePrc7114
QPageSize::EnvelopePrc8115
QPageSize::EnvelopePrc9116
QPageSize::EnvelopePrc10117
QPageSize::EnvelopeYou4118
QPageSize::LastPageSizeEnvelopeYou4= EnvelopeYou4

역사적인 이유로 인해 QPageSize::Executive는 표준 Postscript 및 Windows Executive 크기와 동일하지 않으므로 대신 QPageSize::ExecutiveStandard를 사용하십시오.

포스트스크립트 표준 크기 QPageSize::Folio는 Windows DMPAPER_FOLIO 크기와 다르므로 필요한 경우 포스트스크립트 표준 크기 QPageSize::FanFoldGermanLegal을 사용하세요.

enum QPageSize::SizeMatchPolicy

상수설명
QPageSize::FuzzyMatch0허용 오차 범위 내에 있는 경우 표준 페이지 크기에 맞춥니다.
QPageSize::FuzzyOrientationMatch1방향에 관계없이 허용 오차 범위 내에 있는 경우 표준 페이지 크기에 맞춥니다.
QPageSize::ExactMatch2크기가 정확히 일치하는 경우에만 표준 페이지 크기에 맞춥니다.

enum QPageSize::Unit

이 열거형 유형은 페이지 크기의 측정 단위를 지정하는 데 사용됩니다.

Constant설명
QPageSize::Millimeter0
QPageSize::Point11/72인치
QPageSize::Inch2
QPageSize::Pica31/72피트, 1/6인치, 12포인트
QPageSize::Didot41/72인치, 프렌치 인치, 0.375mm
QPageSize::Cicero51/6인치, 12디닷, 4.5mm

멤버 기능 문서

QPageSize::QPageSize()

널 QPageSize를 생성합니다.

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

표준 pageSize 의 QPageSize를 생성합니다.

pageSizeQPageSize::Custom 인 경우 결과 QPageSize는 유효하지 않습니다. 대신 사용자 정의 크기 생성자를 사용하세요.

[explicit] QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

일치하는 matchPolicy 을 사용하여 주어진 pointSize 의 QPageSize를 포인트로 만듭니다.

주어진 pointSize 이 표준 QPageSize::PageSizeId 과 일치하면 해당 페이지 크기가 사용됩니다. matchPolicyFuzzyMatch 인 경우 pointSize 이 표준 크기로 조정될 수 있습니다. 이를 방지하려면 matchPolicy 대신 ExactMatch 을 사용하세요.

지정된 pointSize 이 표준 QPageSize::PageSizeId 이 아닌 경우 QPageSize::Custom 크기가 생성됩니다.

name 이 null이면 표준 현지화된 이름이 사용됩니다. 사용자 정의 페이지 크기인 경우 "사용자 정의 (너비 x 높이)" 형식의 사용자 정의 이름이 만들어집니다.

matchPolicy 기본값은 FuzzyMatch 입니다.

[explicit] QPageSize::QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

units 에 주어진 size 의 사용자 정의 페이지를 만듭니다.

주어진 size 이 표준 QPageSize::PageSizeId 과 일치하면 해당 페이지 크기가 사용됩니다. matchPolicyFuzzyMatch 인 경우 size 이 표준 크기로 조정될 수 있습니다. 이를 방지하려면 matchPolicy 대신 ExactMatch 을 사용하세요.

지정된 size 이 표준 QPageSize::PageSizeId 이 아닌 경우 QPageSize::Custom 크기가 생성됩니다. 원래 단위 크기는 유지되며 다른 모든 단위 크기 계산의 기준으로 사용됩니다.

name 이 null인 경우 사용자 정의 이름이 "사용자 정의 (너비 x 높이)" 형식으로 생성되며, 여기서 크기는 제공된 단위로 표현됩니다.

QPageSize::QPageSize(const QPageSize &other)

생성자 복사, other 을 여기로 복사합니다.

[noexcept] QPageSize::~QPageSize()

페이지를 삭제합니다.

QSizeF QPageSize::definitionSize() const

페이지 크기의 정의 크기를 반환합니다.

표준 페이지 크기의 경우 관련 표준에 정의된 크기(예: ISO A4는 밀리미터로 정의되고 ANSI 레터는 인치로 정의됨)가 됩니다.

사용자 지정 페이지 크기의 경우 페이지 크기 객체를 만드는 데 사용된 원래 크기가 됩니다.

QPageSize 이 유효하지 않은 경우 QSizeF 이 유효하지 않습니다.

definitionUnits()도 참조하세요 .

[static] QSizeF QPageSize::definitionSize(QPageSize::PageSizeId pageSizeId)

표준의 정의 크기를 반환합니다 pageSizeId.

정의 단위를 얻으려면 QPageSize::definitionUnits()를 호출합니다.

QPageSize::Unit QPageSize::definitionUnits() const

페이지 크기의 정의 단위를 반환합니다.

표준 페이지 크기의 경우 관련 표준에 정의된 단위(예: ISO A4는 밀리미터로 정의되고 ANSI 레터는 인치로 정의됨)가 됩니다.

사용자 지정 페이지 크기의 경우 페이지 크기 객체를 만드는 데 사용된 원래 단위가 됩니다.

QPageSize 이 유효하지 않은 경우 QPageSize::Unit 이 유효하지 않습니다.

definitionSize()도 참조하세요 .

[static] QPageSize::Unit QPageSize::definitionUnits(QPageSize::PageSizeId pageSizeId)

표준의 정의 단위를 반환합니다 pageSizeId.

정의 크기를 얻으려면 QPageSize::definitionSize()를 호출합니다.

QPageSize::PageSizeId QPageSize::id() const

페이지의 표준 QPageSize::PageSizeId 또는 QPageSize::Custom 을 반환합니다.

QPageSize 이 유효하지 않은 경우 ID는 QPageSize::Custom 이 됩니다.

[static] QPageSize::PageSizeId QPageSize::id(int windowsId)

주어진 Windows DMPAPER 열거형 값 windowsId 에 대해 PageSizeId 을 반환합니다.

일치하는 PageSizeId 이 없으면 QPageSize::Custom 이 반환됩니다.

[static] QPageSize::PageSizeId QPageSize::id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

주어진 matchPolicy 을 사용하여 주어진 pointSize 의 표준 QPageSize::PageSizeId 을 포인트로 반환합니다.

FuzzyMatch 을 사용하는 경우 반환된 PageSizeId 의 포인트 크기가 전달한 pointSize 과 정확히 일치하지 않을 수 있습니다. 반환된 PageSizeId 을 사용하여 QPageSize::sizePoints()를 호출하여 PageSizeId 의 실제 포인트 크기를 확인한 후 계산에 사용해야 합니다.

[static] QPageSize::PageSizeId QPageSize::id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

주어진 matchPolicy 을 사용하여 units 에서 주어진 size 의 표준 QPageSize::PageSizeId 을 반환합니다.

FuzzyMatch 을 사용하는 경우 반환된 PageSizeId 의 단위 크기가 전달한 size 과 정확히 일치하지 않을 수 있습니다. 반환된 PageSizeId 을 사용하여 QPageSize::size()를 호출하여 PageSizeId 의 실제 단위 크기를 확인한 후 계산에 사용해야 합니다.

bool QPageSize::isEquivalentTo(const QPageSize &other) const

이 페이지가 other 페이지와 동일한 경우, 즉 이름과 같은 다른 속성과 관계없이 페이지의 크기가 동일한 경우 true 을 반환합니다.

bool QPageSize::isValid() const

이 페이지 크기가 유효하면 true 을 반환합니다.

페이지 크기가 잘못된 PageSizeId, 음수 또는 잘못된 QSize 또는 QSizeF, 또는 널 생성자를 사용하여 생성된 경우 페이지 크기가 유효하지 않을 수 있습니다.

QString QPageSize::key() const

페이지 크기의 고유 키를 반환합니다.

기본적으로 이 키는 페이지 크기에 대한 PPD 표준 미디어 옵션 키워드 또는 PPD 사용자 지정 형식 키입니다. QPageSize 인스턴스를 인쇄 장치에서 가져온 경우 이 키는 인쇄 장치에서 제공한 키이며 표준 키와 다를 수 있습니다.

QPageSize 이 유효하지 않은 경우 키는 빈 문자열이 됩니다.

이 키는 최종 사용자에게 절대 표시되어서는 안 되며 내부 키로만 사용됩니다. 사람이 읽을 수 있는 이름은 name()를 사용합니다.

name()도 참조하세요 .

[static] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

표준 pageSizeId 의 PPD 미디어 옵션 키워드를 반환합니다.

QPageSize 가 유효하지 않으면 키가 비어 있습니다.

QString QPageSize::name() const

페이지 크기에 대해 사람이 읽을 수 있는 현지화된 이름을 반환합니다.

QPageSize 인스턴스가 인쇄 장치에서 가져온 경우 사용되는 이름은 인쇄 장치에서 제공한 이름입니다. 인쇄 장치가 현재 기본 로캘 언어를 지원하지 않을 수 있습니다.

QPageSize 이 유효하지 않은 경우 이름은 빈 문자열이 됩니다.

[static] QString QPageSize::name(QPageSize::PageSizeId pageSizeId)

표준의 현지화된 이름 pageSizeId 을 반환합니다.

QPageSize 이 유효하지 않으면 이름이 비어 있습니다.

QRectF QPageSize::rect(QPageSize::Unit units) const

필요한 units 에 페이지 사각형을 반환합니다.

QPageSize 이 유효하지 않은 경우 QRect 은 유효하지 않습니다.

QRect QPageSize::rectPixels(int resolution) const

주어진 resolution 에서 디바이스 픽셀 단위의 페이지 사각형을 반환합니다.

QPageSize 이 유효하지 않은 경우 QRect 은 유효하지 않습니다.

QRect QPageSize::rectPoints() const

포스트스크립트 포인트(1/72인치)로 페이지 직사각형을 반환합니다.

QPageSize 가 유효하지 않으면 QRect 도 유효하지 않습니다.

QSizeF QPageSize::size(QPageSize::Unit units) const

필수 units 에 페이지의 크기를 반환합니다.

QPageSize 이 유효하지 않은 경우 QSizeF 은 유효하지 않습니다.

[static] QSizeF QPageSize::size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)

요청된 units 에서 표준 pageSizeId 의 크기를 반환합니다.

QSize QPageSize::sizePixels(int resolution) const

주어진 resolution 에서 페이지의 크기를 디바이스 픽셀 단위로 반환합니다.

QPageSize 이 유효하지 않은 경우 QSize 은 유효하지 않습니다.

[static] QSize QPageSize::sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)

주어진 resolution 에 대한 표준 pageSizeId 의 크기를 디바이스 픽셀 단위로 반환합니다.

QSize QPageSize::sizePoints() const

페이지의 크기를 포스트스크립트 포인트(1/72인치)로 반환합니다.

QPageSize 이 유효하지 않은 경우 QSize 은 유효하지 않습니다.

[static] QSize QPageSize::sizePoints(QPageSize::PageSizeId pageSizeId)

표준 pageSizeId 의 크기를 포인트 단위로 반환합니다.

[noexcept] void QPageSize::swap(QPageSize &other)

QPageSizeother 으로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

int QPageSize::windowsId() const

페이지 크기에 대한 Windows DMPAPER 열거형 값을 반환합니다.

모든 유효한 PPD 페이지 크기가 Windows에 해당하는 것은 아니며, 이 경우 0이 반환됩니다.

QPageSize 이 유효하지 않은 경우 Windows ID는 0이 됩니다.

id()도 참조하세요 .

[static] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

표준의 Windows DMPAPER 열거형 값 pageSizeId 을 반환합니다.

모든 유효한 PPD 페이지 크기에 Windows에 해당하는 값이 있는 것은 아니며, 이 경우 0이 반환됩니다.

[noexcept] QPageSize &QPageSize::operator=(QPageSize &&other)

이동 - other 을 이 QPageSize 인스턴스에 할당하여 관리 포인터의 소유권을 이 인스턴스로 이전합니다.

QPageSize &QPageSize::operator=(const QPageSize &other)

할당 연산자, other 을 할당합니다.

관련 비회원

bool operator!=(const QPageSize &lhs, const QPageSize &rhs)

페이지 크기 lhs 가 페이지 크기 rhs 와 같지 않은 경우, 즉 페이지 크기가 다른 속성을 가진 경우 true 를 반환합니다. 현재 속성은 크기와 이름입니다.

bool operator==(const QPageSize &lhs, const QPageSize &rhs)

페이지 크기 lhs 가 페이지 크기 rhs 와 같을 경우, 즉 페이지 크기가 동일한 속성을 가진 경우 true 를 반환합니다. 현재 속성은 크기와 이름입니다.

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