QTextFrame Class
Die Klasse „QTextFrame“ stellt einen Rahmen in einem „ QTextDocument “ dar. Mehr...
| Header: | #include <QTextFrame> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QTextObject |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextFrame ist Teil der Rich-Text-Verarbeitungs-APIs.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Typen
Öffentliche Funktionen
| QTextFrame(QTextDocument *document) | |
| virtual | ~QTextFrame() |
| QTextFrame::iterator | begin() const |
| QList<QTextFrame *> | childFrames() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| int | firstPosition() const |
| QTextFrameFormat | frameFormat() const |
| QTextCursor | lastCursorPosition() const |
| int | lastPosition() const |
| QTextFrame * | parentFrame() const |
| void | setFrameFormat(const QTextFrameFormat &format) |
Ausführliche Beschreibung
Textrahmen sorgen für die Strukturierung des Textes in einem Dokument. Sie dienen als generische Container für andere Dokumentelemente. Rahmen werden in der Regel mit der Funktion „ QTextCursor::insertFrame()“ erstellt.
Mit Rahmen lassen sich hierarchische Strukturen in Rich-Text-Dokumenten erstellen. Jedes Dokument verfügt über einen Stammrahmen (QTextDocument::rootFrame()), und jeder Rahmen unterhalb des Stammrahmens hat einen übergeordneten Rahmen sowie eine (möglicherweise leere) Liste von untergeordneten Rahmen. Der übergeordnete Rahmen kann mit parentFrame() ermittelt werden, und die Funktion childFrames() liefert eine Liste der untergeordneten Rahmen.
Jeder Frame enthält mindestens einen Textblock, in den Textcursor neue Dokumentelemente einfügen können. Daher wird die Klasse ` QTextFrame::iterator ` verwendet, um sowohl die Blöcke als auch die untergeordneten Frames innerhalb eines bestimmten Frames zu durchlaufen. Das erste und das letzte untergeordnete Element im Frame lassen sich mit ` begin()` und ` end()` ermitteln.
Ein Frame verfügt außerdem über ein Format (spezifiziert mit ` QTextFrameFormat`), das mit ` setFormat()` festgelegt und mit ` format()` ausgelesen werden kann.
Es können Textcursor abgerufen werden, die auf die erste und letzte gültige Cursorposition innerhalb eines Frames zeigen; verwenden Sie hierfür die Funktionen firstCursorPosition() und lastCursorPosition(). Die Ausdehnung des Frames im Dokument lässt sich mit firstPosition() und lastPosition() ermitteln.
Sie können den Inhalt eines Rahmens mithilfe der Klasse ` QTextFrame::iterator ` durchlaufen: Diese bietet schreibgeschützten Zugriff auf die interne Liste der Textblöcke und untergeordneten Rahmen.
Siehe auch „ QTextCursor “ und „ QTextDocument “.
Dokumentation zu Mitgliedstypen
QTextFrame::Iterator
Synonym im Qt-Stil für „ QTextFrame::iterator “.
Dokumentation der Mitgliedsfunktionen
[explicit] QTextFrame::QTextFrame(QTextDocument *document)
Erstellt einen neuen leeren Rahmen für den Text „ document “.
[virtual noexcept] QTextFrame::~QTextFrame()
Löscht den Textrahmen.
Warnung: Textrahmen gehören zum Dokument, daher sollten Sie sie niemals selbst löschen. Um einen Rahmen aus dem Dokument zu entfernen, löschen Sie dessen Inhalt mithilfe eines „ QTextCursor “.
QTextFrame::iterator QTextFrame::begin() const
Gibt einen Iterator zurück, der auf das erste Dokumentelement innerhalb des Frames verweist. Weitere Informationen finden Sie im Dokument „STL-style-Iterators “.
Siehe auch ` end()`.
QList<QTextFrame *> QTextFrame::childFrames() const
Gibt eine (möglicherweise leere) Liste der untergeordneten Frames des Frames zurück.
Siehe auch „ parentFrame()“.
QTextFrame::iterator QTextFrame::end() const
Gibt einen Iterator zurück, der auf die Position hinter dem letzten Dokumentelement innerhalb des Frames zeigt. Weitere Informationen finden Sie im Dokument „STL-Style Iterators “.
Siehe auch ` begin()`.
QTextCursor QTextFrame::firstCursorPosition() const
Gibt die erste Cursorposition innerhalb des Frames zurück.
Siehe auch lastCursorPosition(), firstPosition() und lastPosition().
int QTextFrame::firstPosition() const
Gibt die Position des ersten Dokuments innerhalb des Frames zurück.
Siehe auch lastPosition(), firstCursorPosition() und lastCursorPosition().
QTextFrameFormat QTextFrame::frameFormat() const
Gibt das Format des Frames zurück.
Siehe auch ` setFrameFormat()`.
QTextCursor QTextFrame::lastCursorPosition() const
Gibt die letzte Cursorposition innerhalb des Frames zurück.
Siehe auch „ firstCursorPosition()“, „ firstPosition()“ und „ lastPosition()“.
int QTextFrame::lastPosition() const
Gibt die letzte Dokumentposition innerhalb des Frames zurück.
Siehe auch firstPosition(), firstCursorPosition() und lastCursorPosition().
QTextFrame *QTextFrame::parentFrame() const
Gibt den übergeordneten Frame des Frames zurück. Ist der Frame der Root-Frame eines Dokuments, wird hier 0 zurückgegeben.
Siehe auch childFrames() und QTextDocument::rootFrame().
void QTextFrame::setFrameFormat(const QTextFrameFormat &format)
Legt die „ format “ des Frames fest.
Siehe auch frameFormat().
© 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.
