このページでは

QTextFrameFormat Class

QTextFrameFormat クラスは、QTextDocument 内のフレームの書式設定情報を提供します。詳細...

ヘッダー: #include <QTextFrameFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
継承元: QTextFormat
継承元:

QTextTableFormat

注:このクラスのすべての関数は再入可能です。

パブリック型

enum BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset }
enum Position { InFlow, FloatLeft, FloatRight }

パブリック関数

QTextFrameFormat()
qreal border() const
QBrush borderBrush() const
QTextFrameFormat::BorderStyle borderStyle() const
qreal bottomMargin() const
QTextLength height() const
bool isValid() const
qreal leftMargin() const
qreal margin() const
qreal padding() const
QTextFormat::PageBreakFlags pageBreakPolicy() const
QTextFrameFormat::Position position() const
qreal rightMargin() const
void setBorder(qreal width)
void setBorderBrush(const QBrush &brush)
void setBorderStyle(QTextFrameFormat::BorderStyle style)
void setBottomMargin(qreal margin)
void setHeight(const QTextLength &height)
void setHeight(qreal height)
void setLeftMargin(qreal margin)
void setMargin(qreal margin)
void setPadding(qreal width)
void setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
void setPosition(QTextFrameFormat::Position policy)
void setRightMargin(qreal margin)
void setTopMargin(qreal margin)
void setWidth(const QTextLength &width)
void setWidth(qreal width)
qreal topMargin() const
QTextLength width() const

詳細な説明

テキストフレームは、1 つ以上のテキストブロックをグループ化し、段落よりも大きな構造層を提供します。フレームのフォーマットは、画面上でのレンダリング方法と配置方法を指定します。フレーム内のテキスト書式の動作を直接指定するものではありませんが、その子要素のレイアウトに対する制約を提供します。

フレームのフォーマットは、画面上のフレームのwidth()およびheight()を定義します。 各フレームには、その内容を長方形のボックスで囲むborder()を設定できます。このボーダーは、フレーム全体を囲むmargin()で囲まれ、フレームの内容はpadding()によってボーダーから分離されます。この仕組みは、HTMLページでカスケードスタイルシート(CSS)が使用するボックスモデルに似ています。

テキストコンテンツの矩形の周囲に、パディング、ボーダー、マージンがどのように配置されるかを示した図。

フレームのposition()は、setPosition()を使用して設定され、周囲のテキストに対する配置方法を決定します。

QTextFrameFormat オブジェクトの有効性は、isValid() 関数を使用して確認できます。

QTextFrame およびQTextBlockFormatも参照してください 。

メンバ型のドキュメント

enum QTextFrameFormat::BorderStyle

この列挙型は、テキストフレームのさまざまな枠線のスタイルを表します。

定数値
QTextFrameFormat::BorderStyle_None0
QTextFrameFormat::BorderStyle_Dotted1
QTextFrameFormat::BorderStyle_Dashed2
QTextFrameFormat::BorderStyle_Solid3
QTextFrameFormat::BorderStyle_Double4
QTextFrameFormat::BorderStyle_DotDash5
QTextFrameFormat::BorderStyle_DotDotDash6
QTextFrameFormat::BorderStyle_Groove7
QTextFrameFormat::BorderStyle_Ridge8
QTextFrameFormat::BorderStyle_Inset9
QTextFrameFormat::BorderStyle_Outset10

関連項目: borderStyle() およびFrameBorderStyle 。

enum QTextFrameFormat::Position

この列挙型は、フレームが周囲のテキストに対してどの位置にあるかを表します。

定数値
QTextFrameFormat::InFlow0
QTextFrameFormat::FloatLeft1
QTextFrameFormat::FloatRight2

関連項目: position() およびCssFloat 。

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

QTextFrameFormat::QTextFrameFormat()

デフォルトのプロパティを持つテキストフレーム形式オブジェクトを作成します。

qreal QTextFrameFormat::border() const

境界線の幅をピクセル単位で返します。

setBorder()も参照してください 。

QBrush QTextFrameFormat::borderBrush() const

フレームの境界線に使用されるブラシを返します。

setBorderBrush()も参照してください 。

QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const

フレームの境界線のスタイルを返します。

setBorderStyle()も参照してください 。

qreal QTextFrameFormat::bottomMargin() const

フレームの下部マージンの幅をピクセル単位で返します。

setBottomMargin()も参照してください 。

QTextLength QTextFrameFormat::height() const

フレームの境界矩形の高さを返します。

setHeight()も参照してください 。

bool QTextFrameFormat::isValid() const

フォーマット記述が有効な場合は `true ` を返し、そうでない場合は `false` を返します。

qreal QTextFrameFormat::leftMargin() const

フレームの左マージンの幅をピクセル単位で返します。

setLeftMargin()も参照してください 。

qreal QTextFrameFormat::margin() const

フレームの外部マージンの幅をピクセル単位で返します。

setMargin()も参照してください 。

qreal QTextFrameFormat::padding() const

フレームの内部パディングの幅をピクセル単位で返します。

setPadding()も参照してください 。

QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const

フレーム/テーブルに対して現在設定されている改ページポリシーを返します。デフォルトは `QTextFormat::PageBreak_Auto` です。

setPageBreakPolicy()も参照してください 。

QTextFrameFormat::Position QTextFrameFormat::position() const

このフレーム形式を持つフレームの位置指定ポリシーを返します。

setPosition()も参照してください 。

qreal QTextFrameFormat::rightMargin() const

フレームの右マージンの幅をピクセル単位で返します。

setRightMargin()も参照してください 。

void QTextFrameFormat::setBorder(qreal width)

フレームの境界線のwidth (ピクセル単位)を設定します。

border()も参照してください 。

void QTextFrameFormat::setBorderBrush(const QBrush &brush)

フレームの境界線に使用するbrush を設定します。

borderBrush()も参照してください 。

void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)

フレームの境界線のstyle を設定します。

borderStyle()も参照してください 。

void QTextFrameFormat::setBottomMargin(qreal margin)

フレームの下端margin をピクセル単位で設定します。

bottomMargin()も参照してください 。

void QTextFrameFormat::setHeight(const QTextLength &height)

フレームのheight を設定します。

height()も参照してください 。

void QTextFrameFormat::setHeight(qreal height)

フレームのheight を設定します。

これはオーバーロードされた関数です。

void QTextFrameFormat::setLeftMargin(qreal margin)

フレームの左端margin をピクセル単位で設定します。

leftMargin()も参照してください 。

void QTextFrameFormat::setMargin(qreal margin)

フレームのmargin をピクセル単位で設定します。このメソッドは、フレームの左、右、上、下のマージンもすべて同じ値に設定します。個々のマージンは、全体的なマージンよりも優先されます。

margin()も参照してください 。

void QTextFrameFormat::setPadding(qreal width)

フレームの内部パディングのwidth をピクセル単位で設定します。

padding()も参照してください 。

void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)

フレーム/表の改ページポリシーを「policy 」に設定します。

pageBreakPolicy()も参照してください 。

void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)

このフレーム形式を使用してフレームを配置するためのpolicy を設定します。

position()も参照してください 。

void QTextFrameFormat::setRightMargin(qreal margin)

フレームの右端の位置(margin )をピクセル単位で設定します。

rightMargin()も参照してください 。

void QTextFrameFormat::setTopMargin(qreal margin)

フレームの上端margin をピクセル単位で設定します。

topMargin()も参照してください 。

void QTextFrameFormat::setWidth(const QTextLength &width)

フレームの境界矩形のwidth を設定します。

width() およびQTextLengthも参照してください 。

void QTextFrameFormat::setWidth(qreal width)

フレームの境界矩形の幅を、指定された固定値width に設定する便利なメソッドです。

これはオーバーロードされた関数です。

qreal QTextFrameFormat::topMargin() const

フレームの上部マージンの幅をピクセル単位で返します。

setTopMargin()も参照してください 。

QTextLength QTextFrameFormat::width() const

フレームの境界矩形の幅を返します。

setWidth() およびQTextLengthも参照してください 。

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