QTextFrameFormat Class
Die Klasse „QTextFrameFormat“ stellt Formatierungsinformationen für Rahmen in einem „ QTextDocument “ bereit. Mehr...
| Header: | #include <QTextFrameFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QTextFormat |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextFrameFormat ist Teil der Rich-Text-Verarbeitungs-APIs und der implizit gemeinsam genutzten Klassen.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Typen
| enum | BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset } |
| enum | Position { InFlow, FloatLeft, FloatRight } |
Öffentliche Funktionen
| 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 |
Ausführliche Beschreibung
Ein Textrahmen fasst einen oder mehrere Textblöcke zusammen und bietet damit eine Struktur, die über den Absatz hinausgeht. Das Format eines Rahmens legt fest, wie dieser auf dem Bildschirm dargestellt und positioniert wird. Es legt nicht direkt das Verhalten der Textformatierung innerhalb des Rahmens fest, sondern gibt Vorgaben für das Layout seiner untergeordneten Elemente vor.
Das Rahmenformat definiert die „ width “ () und die „ height “ () des Rahmens auf dem Bildschirm. Jeder Rahmen kann einen „ border “ () haben, der seinen Inhalt mit einem rechteckigen Kasten umgibt. Der Rahmen wird von einem „ margin “ () umgeben, und der Inhalt des Rahmens wird durch den „ padding “ () des Rahmens vom Rahmen getrennt gehalten. Dieses Schema ähnelt dem Box-Modell, das von Cascading Style Sheets für HTML-Seiten verwendet wird.

Die Positionierung ( position()) eines Rahmens wird mit der Funktion „ setPosition()“ festgelegt und bestimmt, wie er relativ zum umgebenden Text positioniert wird.
Die Gültigkeit eines QTextFrameFormat-Objekts lässt sich mit der Funktion „ isValid “ () feststellen.
Siehe auch „ QTextFrame “ und „ QTextBlockFormat “.
Dokumentation zu den Mitgliedstypen
enum QTextFrameFormat::BorderStyle
Diese Aufzählung beschreibt verschiedene Rahmenstile für den Textrahmen.
| Konstante | Wert |
|---|---|
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 |
Siehe auch borderStyle() und FrameBorderStyle.
enum QTextFrameFormat::Position
Diese Aufzählung beschreibt, wie sich ein Rahmen relativ zum umgebenden Text positioniert.
| Konstante | Wert |
|---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
Dokumentation der Mitgliedsfunktionen
QTextFrameFormat::QTextFrameFormat()
Erstellt ein Textrahmen-Formatobjekt mit den Standardeigenschaften.
qreal QTextFrameFormat::border() const
Gibt die Breite des Rahmens in Pixeln zurück.
Siehe auch „ setBorder()“.
QBrush QTextFrameFormat::borderBrush() const
Gibt den Pinsel zurück, der für den Rahmen des Frames verwendet wurde.
Siehe auch „ setBorderBrush()“.
QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const
Gibt den Stil des Rahmenrandes zurück.
Siehe auch „ setBorderStyle()“.
qreal QTextFrameFormat::bottomMargin() const
Gibt die Breite des unteren Randes des Rahmens in Pixeln zurück.
Siehe auch „ setBottomMargin()“.
QTextLength QTextFrameFormat::height() const
Gibt die Höhe des Rahmenrechtecks des Frames zurück.
Siehe auch „ setHeight()“.
bool QTextFrameFormat::isValid() const
Gibt „ true “ zurück, wenn die Formatbeschreibung gültig ist; andernfalls wird „ false “ zurückgegeben.
qreal QTextFrameFormat::leftMargin() const
Gibt die Breite des linken Randes des Rahmens in Pixeln zurück.
Siehe auch „ setLeftMargin()“.
qreal QTextFrameFormat::margin() const
Gibt die Breite des äußeren Randes des Frames in Pixeln zurück.
Siehe auch „ setMargin()“.
qreal QTextFrameFormat::padding() const
Gibt die Breite des internen Abstands des Frames in Pixeln zurück.
Siehe auch ` setPadding()`.
QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const
Gibt die aktuell festgelegte Seitenumbruchregel für den Rahmen/die Tabelle zurück. Der Standardwert lautet „ QTextFormat::PageBreak_Auto “.
Siehe auch „ setPageBreakPolicy()“.
QTextFrameFormat::Position QTextFrameFormat::position() const
Gibt die Positionierungsrichtlinie für Frames mit diesem Frame-Format zurück.
Siehe auch setPosition().
qreal QTextFrameFormat::rightMargin() const
Gibt die Breite des rechten Randes des Rahmens in Pixeln zurück.
Siehe auch „ setRightMargin()“.
void QTextFrameFormat::setBorder(qreal width)
Legt die „ width “ (in Pixeln) des Rahmenrandes fest.
Siehe auch „ border()“.
void QTextFrameFormat::setBorderBrush(const QBrush &brush)
Legt die für den Rahmen des Frames verwendete „ brush “ fest.
Siehe auch borderBrush().
void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)
Legt die „ style “ des Rahmenrandes fest.
Siehe auch „ borderStyle()“.
void QTextFrameFormat::setBottomMargin(qreal margin)
Legt die untere Rahmen margin e in Pixeln fest.
Siehe auch ` bottomMargin()`.
void QTextFrameFormat::setHeight(const QTextLength &height)
Legt den „ height “ des Frames fest.
Siehe auch height().
void QTextFrameFormat::setHeight(qreal height)
Legt den „ height “ des Frames fest.
Dies ist eine überladene Funktion.
void QTextFrameFormat::setLeftMargin(qreal margin)
Legt die linke margin des Rahmens in Pixeln fest.
Siehe auch ` leftMargin()`.
void QTextFrameFormat::setMargin(qreal margin)
Legt den Rahmenabstand „ margin “ in Pixeln fest. Diese Methode setzt außerdem die linken, rechten, oberen und unteren Ränder des Rahmens auf denselben Wert. Die einzelnen Ränder haben Vorrang vor dem allgemeinen Rand.
Siehe auch ` margin()`.
void QTextFrameFormat::setPadding(qreal width)
Legt die „ width “ des internen Abstands des Frames in Pixeln fest.
Siehe auch padding().
void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
Legt die Seitenumbruchrichtlinie für den Rahmen/die Tabelle auf „ policy “ fest.
Siehe auch ` pageBreakPolicy()`.
void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)
Legt die „ policy “ für die Positionierung von Frames mit diesem Frame-Format fest.
Siehe auch position().
void QTextFrameFormat::setRightMargin(qreal margin)
Legt die rechte margin des Rahmens in Pixeln fest.
Siehe auch „ rightMargin()“.
void QTextFrameFormat::setTopMargin(qreal margin)
Legt die obere Rahmen margin des Frames in Pixeln fest.
Siehe auch ` topMargin()`.
void QTextFrameFormat::setWidth(const QTextLength &width)
Legt die „ width “ des Rahmenrechtecks des Frames fest.
Siehe auch „ width()“ und „ QTextLength “.
void QTextFrameFormat::setWidth(qreal width)
Eine Komfortmethode, die die Breite des Rahmenrechtecks auf den angegebenen festen Wert „ width “ setzt.
Dies ist eine überladene Funktion.
qreal QTextFrameFormat::topMargin() const
Gibt die Breite des oberen Randes des Rahmens in Pixeln zurück.
Siehe auch „ setTopMargin()“.
QTextLength QTextFrameFormat::width() const
Gibt die Breite des Rahmenrechtecks des Frames zurück.
Siehe auch „ setWidth()“ und „ 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.