Sur cette page

QTextDocumentFragment Class

La classe QTextDocumentFragment représente un morceau de texte formaté provenant d'un document QTextDocument. Plus....

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

Note : 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 riche qui peut être inséré dans un document QTextDocument. Un fragment de document peut être créé à partir d'un document QTextDocument, de la sélection d'un document QTextCursor ou d'un autre fragment de document. Les fragments de document peuvent également être créés par les fonctions statiques fromPlainText() et fromHtml().

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

Documentation des fonctions membres

QTextDocumentFragment::QTextDocumentFragment()

Construit un QTextDocumentFragment vide.

Voir également isEmpty().

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

Crée un QTextDocumentFragment à partir de la sélection de 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 le site document en un QTextDocumentFragment. Notez que le QTextDocumentFragment ne stocke que le contenu du document, et non les méta-informations telles que le titre du document.

QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)

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

[noexcept] QTextDocumentFragment::~QTextDocumentFragment()

Détruit le fragment de document.

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

Renvoie une page QTextDocumentFragment basée sur le morceau arbitraire de HTML dans la page text donnée. Le formatage est préservé autant que possible ; par exemple, "<b>bold</b>" deviendra un fragment de document avec le texte "bold" avec un format de caractère 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 par l'intermédiaire de resourceProvider.

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

Retourne un QTextDocumentFragment basé sur le texte markdown donné avec le features spécifié. Le dialecte GitHub est utilisé par défaut.

Le formatage est préservé autant que possible ; par exemple, **bold** deviendra un fragment de document contenant le texte "bold" avec un style de caractère 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 qui contient l'adresse plainText donnée.

Lors de l'insertion d'un tel fragment dans un document QTextDocument, le format actuel des caractères du document 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 en HTML.

Voir aussi toPlainText(), toMarkdown(), et QTextDocument::toHtml().

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

Renvoie le contenu du fragment de document en Markdown, avec le dialecte spécifié features. Le dialecte GitHub est utilisé par défaut.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi toPlainText() et QTextDocument::toMarkdown().

QString QTextDocumentFragment::toPlainText() const

Cette fonction renvoie la même chose que toRawText(), mais remplace certains caractères unicode par des alternatives ASCII. En particulier, l'espace sans coupure (U+00A0) est remplacé par un espace normal (U+0020), et les séparateurs de paragraphe (U+2029) et de ligne (U+2028) sont remplacés par un saut de ligne (U+000A). Si vous avez besoin du contenu précis 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 en tant que texte brut (c'est-à-dire sans information de formatage).

Cette fonction a été introduite dans Qt 6.4.

Voir aussi 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.