QTextDocumentFragment Class
Die Klasse „QTextDocumentFragment“ repräsentiert einen Abschnitt formatierten Textes aus einem „ QTextDocument “. Mehr...
| Überschrift: | #include <QTextDocumentFragment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextDocumentFragment ist Teil der Rich-Text-Verarbeitungs-APIs und der implizit gemeinsam genutzten Klassen.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Funktionen
| QTextDocumentFragment() | |
| QTextDocumentFragment(const QTextCursor &cursor) | |
| QTextDocumentFragment(const QTextDocument *document) | |
| QTextDocumentFragment(const QTextDocumentFragment &other) | |
| ~QTextDocumentFragment() | |
| bool | isEmpty() const |
| QString | toHtml() const |
(since 6.4) QString | toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const |
| QString | toPlainText() const |
(since 6.4) QString | toRawText() const |
| QTextDocumentFragment & | operator=(const QTextDocumentFragment &other) |
Statische öffentliche Mitglieder
| QTextDocumentFragment | fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr) |
(since 6.4) QTextDocumentFragment | fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) |
| QTextDocumentFragment | fromPlainText(const QString &plainText) |
Ausführliche Beschreibung
Ein QTextDocumentFragment ist ein Rich-Text-Fragment, das in ein „ QTextDocument “ eingefügt werden kann. Ein Dokumentfragment kann aus einem „ QTextDocument “, aus der Auswahl eines „ QTextCursor “ oder aus einem anderen Dokumentfragment erstellt werden. Dokumentfragmente können auch mithilfe der statischen Funktionen „ fromPlainText()“ und „ fromHtml()“ erstellt werden.
Der Inhalt eines Dokumentfragments kann mithilfe der Funktion ` toRawText()` als Rohtext, mit ` toPlainText()` als ASCII, mit ` toHtml()` als HTML oder mit ` toMarkdown()` als Markdown abgerufen werden.
Dokumentation zu den Member-Funktionen
QTextDocumentFragment::QTextDocumentFragment()
Erstellt ein leeres QTextDocumentFragment.
Siehe auch ` isEmpty()`.
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)
Erstellt ein QTextDocumentFragment aus der Auswahl des cursor. Wenn der Cursor keine Auswahl enthält, ist das erstellte Fragment leer.
Siehe auch „ isEmpty()“ und „ QTextCursor::selection()“.
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)
Wandelt das angegebene ` document ` in ein `QTextDocumentFragment` um. Beachten Sie, dass das `QTextDocumentFragment` nur den Dokumentinhalt speichert, nicht jedoch Metainformationen wie den Titel des Dokuments.
QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)
Kopierkonstruktor. Erstellt eine Kopie des „ other “-Fragments.
[noexcept] QTextDocumentFragment::~QTextDocumentFragment()
Löscht das Dokumentfragment.
[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)
Gibt ein „ QTextDocumentFragment “ zurück, das auf dem beliebigen HTML-Ausschnitt in der angegebenen „ text “ basiert. Die Formatierung wird so weit wie möglich beibehalten; beispielsweise wird aus „<b>bold</b>“ ein Dokumentfragment mit dem Text „bold“ in fetter Schrift.
Wenn der bereitgestellte HTML-Code Verweise auf externe Ressourcen wie importierte Stylesheets enthält, werden diese über das ` resourceProvider` geladen.
[static, since 6.4] QTextDocumentFragment QTextDocumentFragment::fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)
Gibt ein „ QTextDocumentFragment “ zurück, das auf dem angegebenen Text „ markdown “ mit dem angegebenen „ features “ basiert. Der Standardwert ist der GitHub-Dialekt.
Die Formatierung wird so weit wie möglich beibehalten; beispielsweise wird aus „ **bold** “ ein Dokumentfragment, das den Text „bold“ mit dem Zeichenstil „fett“ enthält.
Hinweis: Das Laden externer Ressourcen wird nicht unterstützt.
Diese Funktion wurde in Qt 6.4 eingeführt.
[static] QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)
Gibt ein Dokumentfragment zurück, das das angegebene plainText enthält.
Beim Einfügen eines solchen Fragments in ein ` QTextDocument ` wird das aktuelle Zeichenformat des für das Einfügen verwendeten ` QTextCursor ` als Format für den Text verwendet.
bool QTextDocumentFragment::isEmpty() const
Gibt „ true “ zurück, wenn das Fragment leer ist; andernfalls wird „ false “ zurückgegeben.
QString QTextDocumentFragment::toHtml() const
Gibt den Inhalt des Dokumentfragments als HTML zurück.
Siehe auch toPlainText(), toMarkdown() und QTextDocument::toHtml().
[since 6.4] QString QTextDocumentFragment::toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const
Gibt den Inhalt des Dokumentfragments als Markdown zurück, wobei der angegebene features verwendet wird. Der Standardwert ist der GitHub-Dialekt.
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch „ toPlainText()“ und „ QTextDocument::toMarkdown()“.
QString QTextDocumentFragment::toPlainText() const
Diese Funktion liefert dasselbe Ergebnis wie „ toRawText()“, ersetzt jedoch einige Unicode-Zeichen durch ASCII-Entsprechungen. Insbesondere wird das geschützte Leerzeichen (U+00A0) durch ein normales Leerzeichen (U+0020) ersetzt, und sowohl Absatztrennzeichen (U+2029) als auch Zeilentrennzeichen (U+2028) werden durch einen Zeilenvorschub (U+000A) ersetzt. Wenn Sie den genauen Inhalt des Dokuments benötigen, verwenden Sie stattdessen toRawText().
Siehe auch toHtml(), toMarkdown() und toRawText().
[since 6.4] QString QTextDocumentFragment::toRawText() const
Gibt den Text des Dokumentfragments als Rohtext zurück (d. h. ohne Formatierungsinformationen).
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch toHtml(), toMarkdown() und toPlainText().
QTextDocumentFragment &QTextDocumentFragment::operator=(const QTextDocumentFragment &other)
Weist diesem Fragment das Fragment „ other “ zu.
© 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.