QTextFrameFormat Class
QTextFrameFormat クラスは、QTextDocument 内のフレームの書式設定情報を提供します。詳細...
| ヘッダー: | #include <QTextFrameFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: | QTextFormat |
| 継承元: |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QTextFrameFormat は、リッチテキスト処理 APIおよび暗黙的に共有されるクラスの一部です。
注:このクラスのすべての関数は再入可能です。
パブリック型
| 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_None | 0 |
QTextFrameFormat::BorderStyle_Dotted | 1 |
QTextFrameFormat::BorderStyle_Dashed | 2 |
QTextFrameFormat::BorderStyle_Solid | 3 |
QTextFrameFormat::BorderStyle_Double | 4 |
QTextFrameFormat::BorderStyle_DotDash | 5 |
QTextFrameFormat::BorderStyle_DotDotDash | 6 |
QTextFrameFormat::BorderStyle_Groove | 7 |
QTextFrameFormat::BorderStyle_Ridge | 8 |
QTextFrameFormat::BorderStyle_Inset | 9 |
QTextFrameFormat::BorderStyle_Outset | 10 |
関連項目: borderStyle() およびFrameBorderStyle 。
enum QTextFrameFormat::Position
この列挙型は、フレームが周囲のテキストに対してどの位置にあるかを表します。
| 定数 | 値 |
|---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
メンバ関数のドキュメント
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.