QTextFragment Class
Die Klasse QTextFragment enthält ein Stück Text in einem QTextDocument mit einem einzigen QTextCharFormat. Mehr...
| Kopfzeile: | #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 Processing APIs.
Hinweis: Alle Funktionen in 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 |
Detaillierte Beschreibung
Ein Textfragment beschreibt ein Stück Text, das in einem einzigen Zeichenformat gespeichert ist. Text, bei 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 jedem Punkt, an dem sich das Format ändert, geteilt und neue Fragmente werden erstellt. Wird beispielsweise der Stil eines Textes in der Mitte eines Satzes geändert, wird das Fragment in drei separate Fragmente aufgeteilt: das erste und dritte mit dem gleichen 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() ermittelt werden. Die Funktion length() gibt die Länge des Textes im Fragment an. position() gibt die Position im Dokument an, an der das Fragment beginnt. Um festzustellen, ob das Fragment eine bestimmte Position innerhalb des Dokuments enthält, verwenden Sie die Funktion contains().
Siehe auch QTextDocument und Rich Text Document Structure.
Dokumentation der Mitgliedsfunktionen
QTextFragment::QTextFragment()
Erzeugt 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 dokumentinternen Liste der Zeichenformate 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 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 len Zeichen dieses Textfragments ab der Position pos entsprechen. Die Positionen der Glyphen sind relativ zur Position des Layouts von QTextBlock.
Wenn pos kleiner als Null ist, wird als Standardwert der Anfang von QTextFragment verwendet. Wenn len kleiner als Null ist, wird als Standardwert 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. es hat eine gültige Position in einem Dokument); 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 reinen Text zurück.
Siehe auch length() und charFormat().
bool QTextFragment::operator!=(const QTextFragment &other) const
Gibt true zurück, wenn sich dieses Textfragment vom other Textfragment unterscheidet (an einer anderen Position); andernfalls wird false zurückgegeben.
bool QTextFragment::operator<(const QTextFragment &other) const
Gibt true zurück, wenn dieses Textfragment früher im Dokument erscheint als das Textfragment other; andernfalls wird false zurückgegeben.
QTextFragment &QTextFragment::operator=(const QTextFragment &other)
Weist den Inhalt (Text und Format) des Textfragments other diesem Textfragment zu.
bool QTextFragment::operator==(const QTextFragment &other) const
Gibt true zurück, wenn dieses Textfragment dasselbe ist (an derselben Position) wie das Textfragment other; andernfalls wird false zurückgegeben.
© 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.
