QTextFragment Class
Die Klasse „QTextFragment“ enthält einen Textabschnitt in einem „ QTextDocument “ mit einem einzigen „ QTextCharFormat “. Mehr...
| Header: | #include <QTextFragment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextFragment ist Teil der Rich-Text-Verarbeitungs-APIs.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Funktionen
| QTextFragment() | |
| QTextFragment(const QTextFragment &other) | |
| QTextCharFormat | charFormat() const |
| int | charFormatIndex() const |
| bool | contains(int position) const |
| QList<QGlyphRun> | glyphRuns(int pos = -1, int len = -1) const |
| bool | isValid() const |
| int | length() const |
| int | position() const |
| QString | text() const |
| bool | operator!=(const QTextFragment &other) const |
| bool | operator<(const QTextFragment &other) const |
| QTextFragment & | operator=(const QTextFragment &other) |
| bool | operator==(const QTextFragment &other) const |
Ausführliche Beschreibung
Ein Textfragment beschreibt einen Textabschnitt, der mit einem einzigen Zeichenformat gespeichert ist. Text, in dem sich das Zeichenformat ändert, kann durch Sequenzen von Textfragmenten mit unterschiedlichen Formaten dargestellt werden.
Wenn der Benutzer den Text in einem Fragment bearbeitet und ein anderes Zeichenformat einführt, wird der Text des Fragments an jeder Stelle, an der sich das Format ändert, aufgeteilt, und es werden neue Fragmente erstellt. Wenn beispielsweise der Stil eines Textabschnitts in der Mitte eines Satzes geändert wird, wird das Fragment in drei separate Fragmente aufgeteilt: das erste und das dritte mit demselben Format wie zuvor und das zweite mit dem neuen Stil. Das erste Fragment enthält den Text vom Anfang des Satzes, das zweite den Text aus der Mitte und das dritte den Text vom Ende des Satzes.
Der Text und das Zeichenformat eines Fragments können mit den Funktionen „ text()“ und „ charFormat()“ abgerufen werden. Die Funktion „ length()“ gibt die Länge des Textes im Fragment an. „ position()“ gibt die Position des Fragmentanfangs im Dokument an. Um festzustellen, ob das Fragment eine bestimmte Position innerhalb des Dokuments enthält, verwenden Sie die Funktion „ contains()“.
Siehe auch „ QTextDocument “ und „Rich-Text-Dokumentstruktur“.
Dokumentation zu den Member-Funktionen
QTextFragment::QTextFragment()
Erstellt ein neues, leeres Textfragment.
QTextFragment::QTextFragment(const QTextFragment &other)
Kopiert den Inhalt (Text und Format) des Textfragments „ other “ in dieses Textfragment.
QTextCharFormat QTextFragment::charFormat() const
Gibt das Zeichenformat des Textfragments zurück.
Siehe auch „ text()“.
int QTextFragment::charFormatIndex() const
Gibt einen Index in der internen Liste der Zeichenformate des Dokuments für das Zeichenformat des Textfragments zurück.
Siehe auch „ QTextDocument::allFormats()“.
bool QTextFragment::contains(int position) const
Gibt „ true “ zurück, wenn das Textfragment den Text an der angegebenen Adresse position im Dokument enthält; andernfalls wird „ false “ zurückgegeben.
QList<QGlyphRun> QTextFragment::glyphRuns(int pos = -1, int len = -1) const
Gibt die Glyphen zurück, die den Zeichen „ len “ dieses Textfragments entsprechen, beginnend an der Position „ pos “. Die Positionen der Glyphen beziehen sich auf die Position des Layouts von „ QTextBlock “.
Ist pos kleiner als Null, wird standardmäßig der Anfang von QTextFragment verwendet. Ist len kleiner als Null, wird standardmäßig die Länge des Fragments verwendet.
Siehe auch „ QGlyphRun“ , „ QTextBlock::layout()“, „ QTextLayout::position()“ und „ QPainter::drawGlyphRun()“.
bool QTextFragment::isValid() const
Gibt „ true “ zurück, wenn es sich um ein gültiges Textfragment handelt (d. h. wenn es eine gültige Position in einem Dokument hat); andernfalls wird „ false “ zurückgegeben.
int QTextFragment::length() const
Gibt die Anzahl der Zeichen im Textfragment zurück.
Siehe auch „ text()“.
int QTextFragment::position() const
Gibt die Position dieses Textfragments im Dokument zurück.
QString QTextFragment::text() const
Gibt das Textfragment als einfachen Text zurück.
Siehe auch length() und charFormat().
bool QTextFragment::operator!=(const QTextFragment &other) const
Gibt „ true “ zurück, wenn sich dieses Textfragment (an einer anderen Position) vom Textfragment „ other “ unterscheidet; andernfalls wird „false“ zurückgegeben.
bool QTextFragment::operator<(const QTextFragment &other) const
Gibt „ true “ zurück, wenn dieses Textfragment im Dokument vor dem Textfragment „ other “ erscheint; andernfalls wird „ false “ zurückgegeben.
QTextFragment &QTextFragment::operator=(const QTextFragment &other)
Weist diesem Textfragment den Inhalt (Text und Format) des Textfragments „ other “ zu.
bool QTextFragment::operator==(const QTextFragment &other) const
Gibt „ true “ zurück, wenn dieses Textfragment (an derselben Position) mit dem Textfragment „ other “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
© 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.
