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: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextFrameFormat ist Teil von Rich Text Processing APIs und Implicitly Shared Classes.
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.
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 ein Rahmen relativ zum umgebenden Text angeordnet ist.
Konstante | Wert |
---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
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.