Auf dieser Seite

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:

QTextTableFormat

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.

Diagramm, das veranschaulicht, wie Innenabstand, Rahmen und Rand um das Rechteck mit dem Textinhalt angeordnet sind.

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.

KonstanteWert
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

Siehe auch borderStyle() und FrameBorderStyle.

enum QTextFrameFormat::Position

Diese Aufzählung beschreibt, wie sich ein Rahmen relativ zum umgebenden Text positioniert.

KonstanteWert
QTextFrameFormat::InFlow0
QTextFrameFormat::FloatLeft1
QTextFrameFormat::FloatRight2

Siehe auch position() und CssFloat.

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.