Sur cette page

QTextDocumentFragment Class

La classe QTextDocumentFragment représente un extrait de texte formaté issu d'un ` QTextDocument`. En savoir plus...

En-tête : #include <QTextDocumentFragment>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

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)

Membres publics statiques

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)

Description détaillée

Un QTextDocumentFragment est un fragment de texte enrichi pouvant être inséré dans un QTextDocument. Un fragment de document peut être créé à partir d’un QTextDocument, de la sélection d’un QTextCursor ou d’un autre fragment de document. Les fragments de document peuvent également être créés à l’aide des fonctions statiques fromPlainText() et fromHtml().

Le contenu d’un fragment de document peut être récupéré sous forme de texte brut à l’aide de la fonction toRawText(), sous forme ASCII avec toPlainText(), sous forme HTML avec toHtml() ou sous forme Markdown avec toMarkdown().

Documentation des fonctions membres

QTextDocumentFragment::QTextDocumentFragment()

Crée un objet `QTextDocumentFragment` vide.

Voir aussi isEmpty().

[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)

Crée un QTextDocumentFragment à partir de la sélection de l'cursor. Si le curseur n'a pas de sélection, le fragment créé est vide.

Voir aussi isEmpty() et QTextCursor::selection().

[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)

Convertit l'objet ` document ` fourni en un `QTextDocumentFragment`. Notez que le `QTextDocumentFragment` ne stocke que le contenu du document, et non les métadonnées telles que le titre du document.

QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)

Constructeur de copie. Crée une copie du fragment « other ».

[noexcept] QTextDocumentFragment::~QTextDocumentFragment()

Supprime le fragment de document.

[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)

Renvoie un ` QTextDocumentFragment ` basé sur un extrait de code HTML arbitraire contenu dans l'text fournie. La mise en forme est conservée autant que possible ; par exemple, « <b>bold</b> » deviendra un fragment de document contenant le texte « bold » en caractères gras.

Si le code HTML fourni contient des références à des ressources externes, telles que des feuilles de style importées, celles-ci seront chargées via l'resourceProvider.

[static, since 6.4] QTextDocumentFragment QTextDocumentFragment::fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)

Renvoie un fragment de document ( QTextDocumentFragment ) basé sur le texte d'markdown donné, avec le style de caractères spécifié ( features). La valeur par défaut est le dialecte GitHub.

La mise en forme est conservée autant que possible ; par exemple, **bold** deviendra un fragment de document contenant le texte « bold » avec un style de caractère en gras.

Remarque : le chargement de ressources externes n’est pas pris en charge.

Cette fonction a été introduite dans Qt 6.4.

[static] QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)

Renvoie un fragment de document contenant l'plainText on fournie.

Lors de l’insertion d’un tel fragment dans un QTextDocument, le format de caractères actuel de l’ QTextCursor utilisé pour l’insertion est utilisé comme format pour le texte.

bool QTextDocumentFragment::isEmpty() const

Renvoie « true » si le fragment est vide ; sinon, renvoie « false ».

QString QTextDocumentFragment::toHtml() const

Renvoie le contenu du fragment de document au format HTML.

Voir également toPlainText(), toMarkdown() et QTextDocument::toHtml().

[since 6.4] QString QTextDocumentFragment::toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const

Renvoie le contenu du fragment de document au format Markdown, en utilisant le dialecte spécifié features. La valeur par défaut est le dialecte GitHub.

Cette fonction a été introduite dans Qt 6.4.

Voir également ` toPlainText()` et ` QTextDocument::toMarkdown()`.

QString QTextDocumentFragment::toPlainText() const

Cette fonction renvoie le même résultat que ` toRawText()`, mais remplace certains caractères Unicode par leurs équivalents ASCII. En particulier, l'espace insécable (U+00A0) est remplacé par un espace normal (U+0020), et les séparateurs de paragraphe (U+2029) et de ligne (U+2028) sont tous deux remplacés par un saut de ligne (U+000A). Si vous avez besoin du contenu exact du document, utilisez plutôt toRawText().

Voir également toHtml(), toMarkdown() et toRawText().

[since 6.4] QString QTextDocumentFragment::toRawText() const

Renvoie le texte du fragment de document sous forme de texte brut (c'est-à-dire sans aucune information de mise en forme).

Cette fonction a été introduite dans Qt 6.4.

Voir également toHtml(), toMarkdown() et toPlainText().

QTextDocumentFragment &QTextDocumentFragment::operator=(const QTextDocumentFragment &other)

Attribue le fragment « other » à ce fragment.

© 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.