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 Standard v4.3 で定義されている標準ページサイズのセットのサポートを実装します。これは、ポイント、ミリメートル、インチでページサイズの標準セットを定義し、これらのサイズが一貫して使用されることを保証します。他のサイズ単位を使用することもできますが、計算結果となるため、必ずしも一貫性があるとは限りません。定義されたポイントサイズは常に整数で、それ以外のサイズはすべて単位の端数になります。

定義されたサイズはつねに幅×高さの順序であり、暗黙のページ向きはありません。QPageSize::Ledger のように、幅が高さよりも大きいページサイズを定義することもできますので、幅と高さの値を比較してページの向きを決定することはできません。

例えば、A4は標準では210mm x 297mm、8.27in x 11.69in、または595pt x 842ptと定義されています。

この単位サイズは保存され、他のすべての単位サイズ計算のベースとして使用されます。

カスタムQSize を使用して QPageSize を作成する場合、QPageSize でサイズを標準ページサイズに合わせるかどうかを選択できます。デフォルトでは、QPaperSize はFuzzyMatch モードを使用します。このモードでは、指定されたページサイズが定義された標準サイズから 3 postscript ポイント以内であれば、標準ページサイズに一致させます。これをオーバーライドして完全一致のみを要求することもできますが、単位間の変換によって簡単に3ポイントが失われ、間違ったページサイズになる可能性があるため、これは推奨されません。

QPageSize インスタンスは、印刷デバイスでサポートされているページサイズを照会して取得することもできます。この場合、返されるローカライズ名は、プリンタ自体によって定義されたものです。印刷デバイスは、現在のデフォルトのロケール言語をサポートしていない可能性があることに注意してください。

このクラスは、ページサイズIDをさまざまな単位サイズに変換するための便利なメソッドも提供しています。

QPagedPaintDevice およびQPdfWriterも参照してください。

メンバ型文書

enum QPageSize::PageSizeId

この enum 型は、Postscript PPD 標準で定義されている利用可能なページサイズを列挙します。これらの値はQPagedPaintDevice とQPrinter で重複しています。

定義されているサイズは以下のとおりです：

定数	値	説明
`QPageSize::A0`	`3`	841 x 1189 mm
`QPageSize::A1`	`4`	594 x 841 mm
`QPageSize::A2`	`5`	420 x 594 mm
`QPageSize::A3`	`6`	297 x 420 mm
`QPageSize::A4`	`7`	210 x 297 mm、8.26 x 11.69インチ
`QPageSize::A5`	`8`	148 x 210 mm
`QPageSize::A6`	`9`	105 x 148 mm
`QPageSize::A7`	`10`	74 x 105 mm
`QPageSize::A8`	`11`	52 x 74 mm
`QPageSize::A9`	`12`	37 x 52 mm
`QPageSize::B0`	`14`	1000 x 1414 mm
`QPageSize::B1`	`15`	707 x 1000 mm
`QPageSize::B2`	`16`	500 x 707 mm
`QPageSize::B3`	`17`	353 x 500 mm
`QPageSize::B4`	`18`	250 x 353 mm
`QPageSize::B5`	`19`	176 x 250 mm、6.93 x 9.84インチ
`QPageSize::B6`	`20`	125 x 176 mm
`QPageSize::B7`	`21`	88 x 125 mm
`QPageSize::B8`	`22`	62 x 88 mm
`QPageSize::B9`	`23`	44 x 62 mm
`QPageSize::B10`	`24`	31 x 44 mm
`QPageSize::C5E`	`25`	163 x 229 mm
`QPageSize::Comm10E`	`26`	105 x 241 mm、米国共通10封筒
`QPageSize::DLE`	`27`	110 x 220 mm
`QPageSize::Executive`	`2`	7.5 x 10インチ、190.5 x 254 mm
`QPageSize::Folio`	`28`	210 x 330 mm
`QPageSize::Ledger`	`29`	431.8 x 279.4 mm
`QPageSize::Legal`	`1`	8.5 x 14インチ、215.9 x 355.6 mm
`QPageSize::Letter`	`0`	8.5 x 11インチ、215.9 x 279.4 mm
`QPageSize::Tabloid`	`30`	279.4 x 431.8 mm
`QPageSize::Custom`	`31`	不明、またはユーザー定義サイズ。
`QPageSize::A10`	`13`
`QPageSize::A3Extra`	`32`
`QPageSize::A4Extra`	`33`
`QPageSize::A4Plus`	`34`
`QPageSize::A4Small`	`35`
`QPageSize::A5Extra`	`36`
`QPageSize::B5Extra`	`37`
`QPageSize::JisB0`	`38`
`QPageSize::JisB1`	`39`
`QPageSize::JisB2`	`40`
`QPageSize::JisB3`	`41`
`QPageSize::JisB4`	`42`
`QPageSize::JisB5`	`43`
`QPageSize::JisB6`	`44`	,
`QPageSize::JisB7`	`45`
`QPageSize::JisB8`	`46`
`QPageSize::JisB9`	`47`
`QPageSize::JisB10`	`48`
`QPageSize::AnsiA`	`Letter`	= レター
`QPageSize::AnsiB`	`Ledger`	= レジャー
`QPageSize::AnsiC`	`49`
`QPageSize::AnsiD`	`50`
`QPageSize::AnsiE`	`51`
`QPageSize::LegalExtra`	`52`
`QPageSize::LetterExtra`	`53`
`QPageSize::LetterPlus`	`54`
`QPageSize::LetterSmall`	`55`
`QPageSize::TabloidExtra`	`56`
`QPageSize::ArchA`	`57`
`QPageSize::ArchB`	`58`
`QPageSize::ArchC`	`59`
`QPageSize::ArchD`	`60`
`QPageSize::ArchE`	`61`
`QPageSize::Imperial7x9`	`62`
`QPageSize::Imperial8x10`	`63`
`QPageSize::Imperial9x11`	`64`
`QPageSize::Imperial9x12`	`65`
`QPageSize::Imperial10x11`	`66`
`QPageSize::Imperial10x13`	`67`
`QPageSize::Imperial10x14`	`68`
`QPageSize::Imperial12x11`	`69`
`QPageSize::Imperial15x11`	`70`
`QPageSize::ExecutiveStandard`	`71`
`QPageSize::Note`	`72`
`QPageSize::Quarto`	`73`
`QPageSize::Statement`	`74`
`QPageSize::SuperA`	`75`
`QPageSize::SuperB`	`76`
`QPageSize::Postcard`	`77`
`QPageSize::DoublePostcard`	`78`
`QPageSize::Prc16K`	`79`
`QPageSize::Prc32K`	`80`
`QPageSize::Prc32KBig`	`81`
`QPageSize::FanFoldUS`	`82`
`QPageSize::FanFoldGerman`	`83`
`QPageSize::FanFoldGermanLegal`	`84`
`QPageSize::EnvelopeB4`	`85`
`QPageSize::EnvelopeB5`	`86`
`QPageSize::EnvelopeB6`	`87`
`QPageSize::EnvelopeC0`	`88`
`QPageSize::EnvelopeC1`	`89`
`QPageSize::EnvelopeC2`	`90`
`QPageSize::EnvelopeC3`	`91`
`QPageSize::EnvelopeC4`	`92`
`QPageSize::EnvelopeC5`	`C5E`	= C5E
`QPageSize::EnvelopeC6`	`93`
`QPageSize::EnvelopeC65`	`94`
`QPageSize::EnvelopeC7`	`95`
`QPageSize::EnvelopeDL`	`DLE`	= DLE
`QPageSize::Envelope9`	`96`
`QPageSize::Envelope10`	`Comm10E`	= コミュ10E
`QPageSize::Envelope11`	`97`
`QPageSize::Envelope12`	`98`
`QPageSize::Envelope14`	`99`
`QPageSize::EnvelopeMonarch`	`100`
`QPageSize::EnvelopePersonal`	`101`
`QPageSize::EnvelopeChou3`	`102`
`QPageSize::EnvelopeChou4`	`103`
`QPageSize::EnvelopeInvite`	`104`
`QPageSize::EnvelopeItalian`	`105`
`QPageSize::EnvelopeKaku2`	`106`
`QPageSize::EnvelopeKaku3`	`107`
`QPageSize::EnvelopePrc1`	`108`
`QPageSize::EnvelopePrc2`	`109`
`QPageSize::EnvelopePrc3`	`110`
`QPageSize::EnvelopePrc4`	`111`
`QPageSize::EnvelopePrc5`	`112`
`QPageSize::EnvelopePrc6`	`113`
`QPageSize::EnvelopePrc7`	`114`
`QPageSize::EnvelopePrc8`	`115`
`QPageSize::EnvelopePrc9`	`116`
`QPageSize::EnvelopePrc10`	`117`
`QPageSize::EnvelopeYou4`	`118`
`QPageSize::LastPageSize`	`EnvelopeYou4`	= EnvelopeYou4

歴史的な理由により、QPageSize::Executiveは標準的なPostScriptやWindowsのExecutiveサイズとは異なります。

Postscriptの標準サイズQPageSize::FolioはWindowsのDMPAPER_FOLIOサイズと異なるので、必要に応じてPostscriptの標準サイズQPageSize::FanFoldGermanLegalを使用してください。

enum QPageSize::SizeMatchPolicy

定数	値	説明
`QPageSize::FuzzyMatch`	`0`	許容範囲内であれば、標準のページサイズに合わせます。
`QPageSize::FuzzyOrientationMatch`	`1`	向きに関係なく、許容範囲内であれば標準のページサイズに合わせます。
`QPageSize::ExactMatch`	`2`	サイズが正確に一致する場合のみ，標準ページサイズに一致する。

enum QPageSize::Unit

この列挙型は、ページサイズの測定単位を指定するために使われます。

定数	値	説明
`QPageSize::Millimeter`	`0`
`QPageSize::Point`	`1`	1/72インチ
`QPageSize::Inch`	`2`
`QPageSize::Pica`	`3`	1/72フィート、1/6インチ、12ポイント
`QPageSize::Didot`	`4`	1/72仏インチ、0.375mm
`QPageSize::Cicero`	`5`	1/6仏インチ、12ディド、4.5mm

メンバー関数ドキュメント

QPageSize::QPageSize()

NULLのQPageSizeを作成する。

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

標準pageSize の QPageSize を作成します。

pageSize がQPageSize::Custom の場合、結果の QPageSize は無効です。代わりにカスタム・サイズのコンストラクタを使用してください。

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

一致するmatchPolicy を使用して、指定されたpointSize の QPageSize を Points で作成します。

指定されたpointSize が標準のQPageSize::PageSizeId と一致する場合、そのページサイズが使用されます。matchPolicy がFuzzyMatch の場合、pointSize が標準サイズに調整される可能性があることに注意してください。これを防ぐには、matchPolicy の代わりにExactMatch を使ってください。

与えられたpointSize が標準のQPageSize::PageSizeId でない場合、QPageSize::Custom サイズが作成されます。

name が NULL の場合は、標準のローカライズ名が使われます。カスタムページサイズの場合は、"Custom (width x height) "という形式のカスタム名が作成されます。

matchPolicy のデフォルトはFuzzyMatch です。

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

与えられたsize のカスタムページをunits に作成します。

与えられたsize が標準のQPageSize::PageSizeId と一致する場合、そのページサイズが使われます。matchPolicy がFuzzyMatch の場合、size が標準サイズに調整される可能性があることに注意してください。これを防ぐには、matchPolicy の代わりにExactMatch を使ってください。

与えられたsize が標準のQPageSize::PageSizeId でない場合、QPageSize::Custom サイズが作成されます。元のユニットサイズは保持され、他のすべてのユニットサイズ計算のベースとして使用されます。

name が NULL の場合、"Custom (width x height)" という形式でカスタム名が作成されます。

QPageSize::QPageSize(const QPageSize &other)

コピーコンストラクタ。other をこのコンストラクタにコピーします。

`[noexcept]` QPageSize::~QPageSize()

ページを破棄します。

QSizeF QPageSize::definitionSize() const

ページサイズの定義サイズを返します。

すなわち、 ISO A4 はミリメートルで定義され、 ANSI Letter はインチで定義されます。

カスタムページサイズの場合、これはページサイズオブジェクトを作成するために用いられた元のサイズとなります。

QPageSize が無効な場合、QSizeF も無効になります。

definitionUnits()も参照 。

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

pageSizeId 標準の定義サイズを返す。

定義単位を取得するには、QPageSize::definitionUnits()を呼び出す。

QPageSize::Unit QPageSize::definitionUnits() const

ページ・サイズの定義単位を返します。

すなわち、 ISO A4 はミリメートル単位で定義され、 ANSI Letter はインチ単位で定義されます。

カスタムページサイズの場合、これはページサイズオブジェクトを作成するために用いられた元の単位になります。

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)

与えられたsize の標準QPageSize::PageSizeId を、与えられたmatchPolicy を使用してunits で返します。

FuzzyMatch を使用する場合、返されるPageSizeId の単位サイズは、渡されたsize と正確に一致しない可能性があります。計算で使用する前に、返されたPageSizeId を使用してQPageSize::size() を呼び出し、PageSizeId の実際の単位サイズを調べる必要がある。

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

このページがother ページと等価である場合、すなわち、name などの他の属性に関係なく、ページのサイズが同じである場合、true を返します。

bool QPageSize::isValid() const

このページ・サイズが有効な場合はtrue を返します。

無効なPageSizeId で作成された場合、または負か無効なQSize かQSizeF で作成された場合、または null コンストラクタで作成された場合には、ページサイズは無効である可能性があります。

QString QPageSize::key() const

ページサイズの一意なキーを返します。

デフォルトでは、これはページサイズの PPD 標準 mediaOption キーワード、または PPD カスタム形式キーワードです。QPageSize インスタンスが印刷デバイスから取得された場合には、これは印刷デバイスが提供するキーとなり、標準キーとは異なる可能性があります。

QPageSize が無効な場合、キーは空文字列になる。

このキーは決してエンドユーザーに見せてはならない。人間が読める名前にするには、name() を使用する。

name()も参照 。

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

標準pageSizeId の PPD mediaOption キーワードを返す。

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 における Device Pixels 単位で返します。

QPageSize が無効なときは、QRect も無効になります。

QRect QPageSize::rectPoints() const

ページの矩形を PostScript Points (1/72 of an inch) で返します。

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 におけるページのサイズを Device Pixels で返します。

QPageSize が無効な場合はQSize も無効となる。

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

指定されたresolution の標準pageSizeId のサイズを Device Pixels で返す。

QSize QPageSize::sizePoints() const

ページのサイズをPostscript Point (1/72インチ)で返す。

QPageSize が無効な場合、QSize も無効となる。

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

標準のpageSizeId のサイズを Points で返す。

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

このQPageSize をother と交換する。この関数は非常に高速で、失敗することはない。

int QPageSize::windowsId() const

ページ・サイズのWindows DMPAPER enum値を返す。

すべての有効なPPDページ・サイズがWindowsに相当するわけではなく、その場合は0が返される。

QPageSize が無効な場合、Windows ID は 0 になる。

id()も参照 。

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

pageSizeId 標準のWindows DMPAPER列挙値を返す。

すべての有効なPPDページ・サイズにWindowsに相当するものがあるとは限らず、その場合は0が返される。

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

Move-other をこのQPageSize インスタンスに割り当て、管理ポインタの所有権をこのインスタンスに移す。

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

Assignment演算子：other をこのインスタンスに割り当てます。