QPageLayout Class

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

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 を持つQPageLayoutを、与えられたunits の中に作成します。

minMargins例えば、物理的な印刷デバイスで印刷できる最小の余白です。

構築されたQPageLayoutはStandardMode 。

与えられたmargins は、ページサイズによって許容される最小余白と最大余白にクランプされます。

QPageLayout::QPageLayout(const QPageLayout &other)

Copyコンストラクタ、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

ページ全体の矩形を、 PostScript ポ イ ン ト （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

塗 り 込み可能な矩形を、 丸めた PostScript ポ イ ン ト （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 を使用して、範囲外の余白の処理方法を指定できます。

margins() およびunits()も参照してください 。

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 を定義 し ます。 た と えば、 物理的な印刷デバ イ ス で印刷で き る 余白の最小値な ど。

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)

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

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

Assignment演算子：other をこのインスタンスに代入します。