QTextFrameFormat Class

Die Klasse QTextFrameFormat liefert Formatierungsinformationen für Rahmen in einem QTextDocument. ...

Kopfzeile: #include <QTextFrameFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Vererbt: QTextFormat
Vererbt von:

QTextTableFormat

Hinweis: Alle Funktionen in 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

Detaillierte Beschreibung

Ein Textrahmen fasst einen oder mehrere Textblöcke zusammen und bietet eine Strukturebene, die größer ist als ein Absatz. Das Format eines Rahmens gibt an, wie er gerendert und auf dem Bildschirm positioniert wird. Es legt nicht direkt das Verhalten der Textformatierung innerhalb des Rahmens fest, sondern gibt Einschränkungen für das Layout seiner Kinder vor.

Das Rahmenformat definiert die width() und height() des Rahmens auf dem Bildschirm. Jeder Rahmen kann einen border() haben, der seinen Inhalt mit einem rechteckigen Rahmen umgibt. Der Rahmen ist von einem margin() um den Rahmen herum umgeben, und der Inhalt des Rahmens wird durch den padding() des Rahmens vom Rahmen getrennt gehalten. Dieses Schema ähnelt dem Rahmenmodell, das von Cascading Style Sheets für HTML-Seiten verwendet wird.

Die position() eines Rahmens wird mit setPosition() festgelegt und bestimmt, wie er relativ zum umgebenden Text angeordnet ist.

Die Gültigkeit eines QTextFrameFormat-Objekts kann mit der Funktion isValid() ermittelt werden.

Siehe auch QTextFrame und QTextBlockFormat.

Dokumentation der 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 ein Rahmen relativ zum umgebenden Text angeordnet ist.

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

Siehe auch position() und CssFloat.

Dokumentation der Mitgliedsfunktionen

QTextFrameFormat::QTextFrameFormat()

Konstruiert ein Textframe-Format-Objekt 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 für den Rahmen verwendeten Pinsel zurück.

Siehe auch setBorderBrush().

QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const

Gibt den Stil der Umrandung des Rahmens 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 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 Rahmens in Pixeln zurück.

Siehe auch setMargin().

qreal QTextFrameFormat::padding() const

Gibt die Breite der internen Polsterung des Rahmens in Pixeln zurück.

Siehe auch setPadding().

QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const

Gibt die aktuell eingestellte Seitenumbruchrichtlinie für den Frame/die Tabelle zurück. Die Vorgabe ist QTextFormat::PageBreak_Auto.

Siehe auch setPageBreakPolicy().

QTextFrameFormat::Position QTextFrameFormat::position() const

Gibt die Positionierungsrichtlinie für Rahmen mit diesem Rahmenformat 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 Pixel) des Rahmens fest.

Siehe auch border().

void QTextFrameFormat::setBorderBrush(const QBrush &brush)

Legt die für den Rahmen verwendete brush fest.

Siehe auch borderBrush().

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

Legt die style des Rahmens fest.

Siehe auch borderStyle().

void QTextFrameFormat::setBottomMargin(qreal margin)

Legt den unteren Rand des Rahmens margin in Pixeln fest.

Siehe auch bottomMargin().

void QTextFrameFormat::setHeight(const QTextLength &height)

Setzt den Rahmen auf height.

Siehe auch height().

void QTextFrameFormat::setHeight(qreal height)

Dies ist eine überladene Funktion.

Setzt den Rahmen height.

void QTextFrameFormat::setLeftMargin(qreal margin)

Legt die linke Seite des Rahmens margin in Pixeln fest.

Siehe auch leftMargin().

void QTextFrameFormat::setMargin(qreal margin)

Setzt den Rahmen margin in Pixel. Diese Methode setzt auch 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)

Setzt die width der internen Auffüllung des Rahmens in Pixel.

Siehe auch padding().

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

Setzt die Seitenumbruchregel für den Rahmen/die Tabelle auf policy.

Siehe auch pageBreakPolicy().

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

Setzt die policy für die Positionierung von Rahmen mit diesem Rahmenformat.

Siehe auch position().

void QTextFrameFormat::setRightMargin(qreal margin)

Legt die rechte Seite des Rahmens margin in Pixeln fest.

Siehe auch rightMargin().

void QTextFrameFormat::setTopMargin(qreal margin)

Legt den oberen Rand des Rahmens margin in Pixeln fest.

Siehe auch topMargin().

void QTextFrameFormat::setWidth(const QTextLength &width)

Legt das Randrechteck des Rahmens width fest.

Siehe auch width() und QTextLength.

void QTextFrameFormat::setWidth(qreal width)

Dies ist eine überladene Funktion.

Convenience-Methode, die die Breite des Rahmenrechtecks auf die angegebene feste Breite width setzt.

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 zurück.

Siehe auch setWidth() und QTextLength.

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