QTextDocument Class
La classe `QTextDocument` contient du texte mis en forme. En savoir plus…
| En-tête : | #include <QTextDocument> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QObject |
- Liste de tous les membres, y compris les membres hérités
- QTextDocument fait partie des API de traitement de texte enrichi.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Types publics
| enum | FindFlag { FindBackward, FindCaseSensitively, FindWholeWords } |
| flags | FindFlags |
| enum | MarkdownFeature { MarkdownNoHTML, MarkdownDialectCommonMark, MarkdownDialectGitHub } |
| flags | MarkdownFeatures |
| enum | MetaInformation { DocumentTitle, DocumentUrl, CssMedia, FrontMatter } |
(since 6.1) | ResourceProvider |
| enum | ResourceType { UnknownResource, HtmlResource, ImageResource, StyleSheetResource, MarkdownResource, UserResource } |
| enum | Stacks { UndoStack, RedoStack, UndoAndRedoStacks } |
Propriétés
|
|
Fonctions publiques
| QTextDocument(QObject *parent = nullptr) | |
| QTextDocument(const QString &text, QObject *parent = nullptr) | |
| virtual | ~QTextDocument() |
| void | addResource(int type, const QUrl &name, const QVariant &resource) |
| void | adjustSize() |
| QList<QTextFormat> | allFormats() const |
| int | availableRedoSteps() const |
| int | availableUndoSteps() const |
| QUrl | baseUrl() const |
(since 6.0) qreal | baselineOffset() const |
| QTextBlock | begin() const |
| int | blockCount() const |
| QChar | characterAt(int pos) const |
| int | characterCount() const |
| virtual void | clear() |
| void | clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks) |
| QTextDocument * | clone(QObject *parent = nullptr) const |
| Qt::CursorMoveStyle | defaultCursorMoveStyle() const |
| QFont | defaultFont() const |
| QString | defaultStyleSheet() const |
| QTextOption | defaultTextOption() const |
| QAbstractTextDocumentLayout * | documentLayout() const |
| qreal | documentMargin() const |
| void | drawContents(QPainter *p, const QRectF &rect = QRectF()) |
| QTextBlock | end() const |
| QTextCursor | find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const |
| QTextCursor | find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = FindFlags()) const |
| QTextCursor | find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const |
| QTextCursor | find(const QString &subString, int position = 0, QTextDocument::FindFlags options = FindFlags()) const |
| QTextBlock | findBlock(int pos) const |
| QTextBlock | findBlockByLineNumber(int lineNumber) const |
| QTextBlock | findBlockByNumber(int blockNumber) const |
| QTextBlock | firstBlock() const |
| qreal | idealWidth() const |
| qreal | indentWidth() const |
| bool | isEmpty() const |
| bool | isLayoutEnabled() const |
| bool | isModified() const |
| bool | isRedoAvailable() const |
| bool | isUndoAvailable() const |
| bool | isUndoRedoEnabled() const |
| QTextBlock | lastBlock() const |
| int | lineCount() const |
| void | markContentsDirty(int position, int length) |
| int | maximumBlockCount() const |
| QString | metaInformation(QTextDocument::MetaInformation info) const |
| QTextObject * | object(int objectIndex) const |
| QTextObject * | objectForFormat(const QTextFormat &f) const |
| int | pageCount() const |
| QSizeF | pageSize() const |
| void | print(QPagedPaintDevice *printer) const |
| void | redo(QTextCursor *cursor) |
| QVariant | resource(int type, const QUrl &name) const |
(since 6.1) QTextDocument::ResourceProvider | resourceProvider() const |
| int | revision() const |
| QTextFrame * | rootFrame() const |
| void | setBaseUrl(const QUrl &url) |
(since 6.0) void | setBaselineOffset(qreal baseline) |
| void | setDefaultCursorMoveStyle(Qt::CursorMoveStyle style) |
| void | setDefaultFont(const QFont &font) |
| void | setDefaultStyleSheet(const QString &sheet) |
| void | setDefaultTextOption(const QTextOption &option) |
| void | setDocumentLayout(QAbstractTextDocumentLayout *layout) |
| void | setDocumentMargin(qreal margin) |
| void | setHtml(const QString &html) |
| void | setIndentWidth(qreal width) |
| void | setLayoutEnabled(bool b) |
| void | setMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub) |
| void | setMaximumBlockCount(int maximum) |
| void | setMetaInformation(QTextDocument::MetaInformation info, const QString &string) |
| void | setPageSize(const QSizeF &size) |
| void | setPlainText(const QString &text) |
(since 6.1) void | setResourceProvider(const QTextDocument::ResourceProvider &provider) |
(since 6.0) void | setSubScriptBaseline(qreal baseline) |
(since 6.0) void | setSuperScriptBaseline(qreal baseline) |
| void | setTextWidth(qreal width) |
| void | setUndoRedoEnabled(bool enable) |
| void | setUseDesignMetrics(bool b) |
| QSizeF | size() const |
(since 6.0) qreal | subScriptBaseline() const |
(since 6.0) qreal | superScriptBaseline() const |
| qreal | textWidth() const |
| QString | toHtml() const |
| QString | toMarkdown(QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub) const |
| QString | toPlainText() const |
| QString | toRawText() const |
| void | undo(QTextCursor *cursor) |
| bool | useDesignMetrics() const |
Emplacements publics
| void | redo() |
| void | setModified(bool m = true) |
| void | undo() |
Signaux
| void | baseUrlChanged(const QUrl &url) |
| void | blockCountChanged(int newBlockCount) |
| void | contentsChange(int position, int charsRemoved, int charsAdded) |
| void | contentsChanged() |
| void | cursorPositionChanged(const QTextCursor &cursor) |
| void | documentLayoutChanged() |
| void | modificationChanged(bool changed) |
| void | redoAvailable(bool available) |
| void | undoAvailable(bool available) |
| void | undoCommandAdded() |
Membres publics statiques
(since 6.1) QTextDocument::ResourceProvider | defaultResourceProvider() |
(since 6.1) void | setDefaultResourceProvider(const QTextDocument::ResourceProvider &provider) |
Fonctions protégées
| virtual QTextObject * | createObject(const QTextFormat &format) |
| virtual QVariant | loadResource(int type, const QUrl &name) |
Description détaillée
QTextDocument est un conteneur destiné aux documents de texte enrichi structurés, prenant en charge le texte formaté et divers types d’éléments de document, tels que les listes, les tableaux, les cadres et les images. Ces documents peuvent être créés pour être utilisés dans un QTextEdit, ou utilisés de manière indépendante.
Chaque élément de document est décrit par un objet de format associé. Chaque objet de format est traité comme un objet unique par QTextDocuments et peut être transmis à la fonction ` objectForFormat()` pour obtenir l'élément de document auquel il s'applique.
Un QTextDocument peut être modifié par programmation à l’aide de la fonction ` QTextCursor`, et son contenu peut être examiné en parcourant la structure du document. L’ensemble de la structure du document est stocké sous la forme d’une hiérarchie d’éléments de document sous le cadre racine, accessible via la fonction ` rootFrame()`. Par ailleurs, si vous souhaitez simplement parcourir le contenu textuel du document, vous pouvez utiliser les fonctions ` begin()`, ` end()` et ` findBlock()` pour récupérer des blocs de texte que vous pourrez examiner et parcourir.
La mise en page d’un document est déterminée par la fonction ` documentLayout()` ; vous pouvez créer votre propre sous-classe de ` QAbstractTextDocumentLayout ` et la définir à l’aide de la fonction ` setDocumentLayout()` si vous souhaitez utiliser votre propre logique de mise en page. Le titre du document et d’autres métadonnées peuvent être obtenus en appelant la fonction metaInformation(). Pour les documents mis à la disposition des utilisateurs via la classe QTextEdit, le titre du document est également accessible via la fonction QTextEdit::documentTitle().
Les fonctions de commodité toPlainText() et toHtml() vous permettent de récupérer le contenu du document au format texte brut et HTML. Le texte du document peut faire l’objet d’une recherche à l’aide des fonctions find().
Les opérations d'annulation et de rétablissement effectuées sur le document peuvent être contrôlées à l'aide de la fonction ` setUndoRedoEnabled()`. Le système d'annulation et de rétablissement peut être contrôlé par un widget d'éditeur via les slots ` undo()` et ` redo()` ; le document fournit également les signaux ` contentsChanged()`, ` undoAvailable()` et ` redoAvailable()` qui informent les widgets d'éditeur connectés de l'état du système d'annulation et de rétablissement. Voici les opérations d'annulation et de rétablissement d'un QTextDocument :
- Insertion ou suppression de caractères. Une séquence d’insertions ou de suppressions au sein d’un même bloc de texte est considérée comme une seule opération d’annulation/rétablissement.
- Insertion ou suppression de blocs de texte. Les séquences d'insertions ou de suppressions au sein d'une même opération (par exemple, en sélectionnant puis en supprimant du texte) sont considérées comme une seule opération d'annulation/rétablissement.
- Modifications du format des caractères de texte.
- Modifications du format des blocs de texte.
- Modifications du format des groupes de blocs de texte.
Voir également « QTextCursor », « QTextEdit » et «Rich Text Processing».
Documentation sur les types de membres
enum QTextDocument::FindFlag
flags QTextDocument::FindFlags
Cette énumération décrit les options disponibles pour la fonction « find » de QTextDocument. Les options peuvent être combinées entre elles à l'aide d'un opérateur « OU » à partir de la liste suivante :
| Constante | Valeur | Description |
|---|---|---|
QTextDocument::FindBackward | 0x00001 | Recherche vers l'arrière plutôt que vers l'avant. |
QTextDocument::FindCaseSensitively | 0x00002 | Par défaut, la recherche ne tient pas compte de la casse. La spécification de cette option modifie le comportement pour effectuer une recherche sensible à la casse. |
QTextDocument::FindWholeWords | 0x00004 | Fait en sorte que la recherche ne trouve que des mots complets. |
Le type `FindFlags` est un `typedef` pour ` QFlags<FindFlag>`. Il stocke une combinaison « OU » de valeurs `FindFlag`.
enum QTextDocument::MarkdownFeature
flags QTextDocument::MarkdownFeatures
Cette énumération permet de sélectionner l'ensemble des fonctionnalités prises en charge lors de la lecture ou de l'écriture de Markdown.
| Constante | Valeur | Description |
|---|---|---|
QTextDocument::MarkdownNoHTML | 0x0020 | 0x0040 | Toutes les balises HTML présentes dans le texte Markdown seront ignorées |
QTextDocument::MarkdownDialectCommonMark | 0 | Uniquement les fonctionnalités normalisées par CommonMark |
QTextDocument::MarkdownDialectGitHub | 0x0004 | 0x0008 | 0x0400 | 0x0100 | 0x0200 | 0x0800 | 0x4000 | 0x100000 | La plupart des fonctionnalités du dialecte GitHub |
Plus précisément, le sous-ensemble pris en charge du dialecte GitHub inclut tout ce qui est présent dans CommonMark, plus :
- la reconnaissance des URL, des adresses « www » et des adresses e-mail, et leur transformation en liens
- le barré
- le soulignement (à ne pas confondre avec l'italique ; dans CommonMark, les deux sont identiques)
- les tableaux
- les listes de tâches
- front matter
Les « éléments préliminaires » sont souvent des métadonnées au format YAML. Qt ne dispose pas actuellement d'un analyseur syntaxique dédié à ce format ; vous pouvez toutefois choisir un analyseur tiers, appeler QTextDocument::metaInformation() pour récupérer l'intégralité du bloc, puis invoquer votre propre analyseur une fois que Qt a analysé le fichier Markdown.
Remarque : la sortie Markdown de la fonction toMarkdown() peut actuellement inclure des fonctionnalités GitHub, même si vous essayez de les désactiver en spécifiant une autre valeur d’énumération. Ce problème sera peut-être corrigé dans une future version de Qt.
Le type `MarkdownFeatures` est un `typedef` pour ` QFlags<MarkdownFeature>`. Il stocke une combinaison « ou » de valeurs `MarkdownFeature`.
Voir également toMarkdown() et setMarkdown().
enum QTextDocument::MetaInformation
Cette énumération décrit les différents types de méta-informations pouvant être ajoutés à un document.
| Constante | Valeur | Description |
|---|---|---|
QTextDocument::DocumentTitle | 0 | Le titre du document. |
QTextDocument::DocumentUrl | 1 | L'URL du document. La fonction loadResource() utilise cette URL comme base lors du chargement des ressources relatives. |
QTextDocument::CssMedia | 2 | Cette valeur est utilisée pour sélectionner la règle « @media » correspondante, le cas échéant, dans une feuille de style CSS spécifiée lorsque la fonction setHtml() est appelée. Cette valeur d'énumération a été introduite dans Qt 6.3. |
QTextDocument::FrontMatter | 3 | Cette valeur sert à sélectionner le contenu de l'en-tête, s'il y en a eu un extrait lors de l'analyse du fichier source (actuellement uniquement à partir du format Markdown). Cette valeur d'énumération a été introduite dans Qt 6.8. |
Voir également ` metaInformation()`, ` setMetaInformation()` et ` setHtml()`.
[alias, since 6.1] QTextDocument::ResourceProvider
Alias de type pour std::function<QVariant(const QUrl&)>.
Ce typedef a été introduit dans Qt 6.1.
enum QTextDocument::ResourceType
Cette énumération décrit les types de ressources pouvant être chargées par la fonction loadResource() de QTextDocument ou par QTextBrowser::setSource().
| Constante | Valeur | Description |
|---|---|---|
QTextDocument::UnknownResource | 0 | Aucune ressource n’est chargée, ou le type de ressource est inconnu. |
QTextDocument::HtmlResource | 1 | La ressource contient du code HTML. |
QTextDocument::ImageResource | 2 | Les types de données actuellement pris en charge sont QMetaType::QPixmap et QMetaType::QImage. Si la variante correspondante est de type QMetaType::QByteArray, Qt tente alors de charger l’image à l’aide de QImage::loadFromData. QMetaType::QIcon n’est actuellement pas pris en charge. L’icône doit d’abord être convertie en l’un des types pris en charge, par exemple à l’aide de QIcon::pixmap. |
QTextDocument::StyleSheetResource | 3 | La ressource contient du CSS. |
QTextDocument::MarkdownResource | 4 | La ressource contient du Markdown. |
QTextDocument::UserResource | 100 | Première valeur disponible pour les types de ressources définis par l'utilisateur. |
Voir également loadResource() et QTextBrowser::sourceType().
enum QTextDocument::Stacks
| Constante | Valeur | Description |
|---|---|---|
QTextDocument::UndoStack | 0x01 | La pile d'annulation. |
QTextDocument::RedoStack | 0x02 | La pile de reprise. |
QTextDocument::UndoAndRedoStacks | UndoStack | RedoStack | Les piles d’annulation et de reprise. |
Documentation sur les propriétés
baseUrl : QUrl
Cette propriété contient l'URL de base utilisée pour résoudre les URL de ressources relatives au sein du document.
Les URL de ressources sont résolues de manière à se trouver dans le même répertoire que la cible de l'URL de base, ce qui signifie que toute partie du chemin d'accès située après le dernier « / » sera ignorée.
| URL de base | URL relative | URL résolue |
|---|---|---|
| file:///chemin/vers/contenu | images/logo.png | file:///chemin/vers/images/logo.png |
| file:///chemin/vers/contenu/ | images/logo.png | file:///chemin/vers/contenu/images/logo.png |
| file:///chemin/vers/contenu/index.html | images/logo.png | file:///chemin/vers/le/contenu/images/logo.png |
| file:///chemin/vers/contenu/images/ | ../images/logo.png | file:///chemin/vers/contenu/images/logo.png |
Fonctions d'accès :
| QUrl | baseUrl() const |
| void | setBaseUrl(const QUrl &url) |
Signal de notification :
| void | baseUrlChanged(const QUrl &url) |
[read-only] blockCount : int
Cette propriété contient le nombre de blocs de texte présents dans le document.
La valeur de cette propriété n'est pas définie dans les documents contenant des tableaux ou des cadres.
Par défaut, si elle est définie, cette propriété a pour valeur 1.
Fonctions d'accès :
| int | blockCount() const |
Voir également lineCount() et characterCount().
defaultFont : QFont
Cette propriété définit la police par défaut utilisée pour afficher le texte du document
Fonctions d'accès :
| QFont | defaultFont() const |
| void | setDefaultFont(const QFont &font) |
defaultStyleSheet : QString
La feuille de style par défaut s'applique à tout nouveau texte au format HTML inséré dans le document, par exemple à l'aide de setHtml() ou QTextCursor::insertHtml().
La feuille de style doit être conforme à la syntaxe CSS 2.1.
Remarque : la modification de la feuille de style par défaut n'a aucun effet sur le contenu existant du document.
Fonctions d'accès :
| QString | defaultStyleSheet() const |
| void | setDefaultStyleSheet(const QString &sheet) |
Voir également Sous-ensemble HTML pris en charge.
defaultTextOption : QTextOption
Cette propriété permet de définir l'option de texte par défaut pour tous les objets « QTextLayout» du document.
Lors de la création d'QTextBlocks, l'option `defaultTextOption` est définie dans leur propriété ` QTextLayout`. Cela permet de définir des propriétés globales pour le document, telles que le mode de retour à la ligne par défaut.
Fonctions d'accès :
| QTextOption | defaultTextOption() const |
| void | setDefaultTextOption(const QTextOption &option) |
documentMargin : qreal
La marge autour du document. La valeur par défaut est 4.
Fonctions d'Access :
| qreal | documentMargin() const |
| void | setDocumentMargin(qreal margin) |
indentWidth : qreal
Renvoie la largeur utilisée pour l'indentation des listes de texte et des blocs de texte.
Les propriétés d'indentation de QTextListFormat et QTextBlockFormat spécifient des multiples de cette valeur. La largeur d'indentation par défaut est de 40.
Fonctions d'accès :
| qreal | indentWidth() const |
| void | setIndentWidth(qreal width) |
[since 6.4] layoutEnabled : bool
Cette propriété détermine si QTextDocument doit recalculer la mise en page après chaque modification
Si cette propriété est définie sur « true », toute modification apportée au document déclenche une mise en page, ce qui garantit un fonctionnement conforme aux attentes mais prend du temps.
La désactivation temporaire de la mise en page peut permettre de gagner du temps lors de modifications multiples (non seulement le contenu textuel, mais aussi la police par défaut, l'option de texte par défaut, etc.), de sorte que le document ne soit mis en page qu'une seule fois à la fin. Cela peut s'avérer utile lorsque la largeur du texte ou la taille de la page n'est pas encore connue, par exemple.
Par défaut, cette propriété est définie sur « true ».
Cette énumération a été introduite dans Qt 6.4.
Fonctions d'accès :
| bool | isLayoutEnabled() const |
| void | setLayoutEnabled(bool b) |
Voir également setTextWidth.
maximumBlockCount : int
Définit la limite du nombre de blocs dans le document.
Spécifie le nombre maximal de blocs que le document peut contenir. Si le document contient plus de blocs que le nombre spécifié par cette propriété, les blocs sont supprimés à partir du début du document.
Une valeur négative ou nulle indique que le document peut contenir un nombre illimité de blocs.
La valeur par défaut est 0.
Notez que la définition de cette propriété applique immédiatement la limite au contenu du document.
La définition de cette propriété désactive également l'historique des actions « Annuler » et « Rétablir ».
Cette propriété n’est pas définie dans les documents comportant des tableaux ou des cadres.
Fonctions d’accès :
| int | maximumBlockCount() const |
| void | setMaximumBlockCount(int maximum) |
modified : bool
Cette propriété indique si le document a été modifié par l'utilisateur
Par défaut, cette propriété prend la valeur « false ».
Fonctions d'accès :
| bool | isModified() const |
| void | setModified(bool m = true) |
Voir également ` modificationChanged()`.
pageSize : QSizeF
Cette propriété contient la taille de page à utiliser pour la mise en page du document
Les unités sont déterminées par le périphérique de sortie sous-jacent. La taille est mesurée en pixels logiques lors de l'affichage à l'écran, et en points (1/72 de pouce) lors de l'impression.
Par défaut, pour un document vide nouvellement créé, cette propriété contient une taille non définie.
Fonctions d'accès :
| QSizeF | pageSize() const |
| void | setPageSize(const QSizeF &size) |
Voir également modificationChanged().
[read-only] size : QSizeF
Cette propriété contient la taille réelle du document. Elle équivaut à documentLayout()->documentSize();
La taille du document peut être modifiée soit en définissant une largeur de texte, soit en définissant la taille d'une page entière.
Notez que la largeur est toujours >= pageSize().width().
Par défaut, pour un document vide nouvellement créé, cette propriété contient une taille qui dépend de la configuration.
Fonctions d’accès :
| QSizeF | size() const |
Voir également setTextWidth(), setPageSize() et idealWidth().
textWidth : qreal
La largeur du texte définit la largeur souhaitée pour le texte dans le document. Si le texte (ou le contenu en général) dépasse la largeur spécifiée, il est réparti sur plusieurs lignes et s'étend verticalement. Si le texte ne peut pas être réparti sur plusieurs lignes pour s'adapter à la largeur spécifiée, il sera plus grand et les propriétés size() et idealWidth() refléteront cette situation.
Si la largeur du texte est définie sur -1, le texte ne sera pas divisé en plusieurs lignes, sauf si cela est imposé par un saut de ligne explicite ou un nouveau paragraphe.
La valeur par défaut est -1.
La définition de la largeur du texte définit également la hauteur de la page sur -1, ce qui entraîne un étirement ou un rétrécissement continu du document dans le sens vertical. Si vous souhaitez que la mise en page du document répartisse le texte sur plusieurs pages, vous devez plutôt définir la propriété pageSize.
Fonctions d’accès :
| qreal | textWidth() const |
| void | setTextWidth(qreal width) |
Voir également size(), idealWidth() et pageSize().
undoRedoEnabled : bool
Cette propriété indique si les fonctions « Annuler » et « Rétablir » sont activées pour ce document
La valeur par défaut est « true ». Si cette option est désactivée, la pile d'annulation est effacée et aucun élément n'y sera ajouté.
Fonctions d'accès :
| bool | isUndoRedoEnabled() const |
| void | setUndoRedoEnabled(bool enable) |
useDesignMetrics : bool
Cette propriété détermine si le document utilise les métriques de conception des polices pour améliorer la précision de la mise en page du texte
Si cette propriété est définie sur « true », la mise en page utilisera les métriques de conception. Dans le cas contraire, ce sont les métriques du périphérique de dessin, telles que définies dans la méthode ` QAbstractTextDocumentLayout::setPaintDevice()`, qui seront utilisées.
L'utilisation des métriques de conception permet à une mise en page d'avoir une largeur qui ne dépend plus du hinting ni de l'arrondi des pixels. Cela signifie qu'une mise en page de texte WYSIWYG devient possible, car la largeur s'adapte de manière beaucoup plus linéaire en fonction des métriques du périphérique de rendu qu'elle ne le ferait autrement.
Par défaut, cette propriété est définie sur « false ».
Fonctions d’accès :
| bool | useDesignMetrics() const |
| void | setUseDesignMetrics(bool b) |
Documentation des fonctions membres
[explicit] QTextDocument::QTextDocument(QObject *parent = nullptr)
Crée un objet `QTextDocument` vide à partir de l'parent` fournie.
[explicit] QTextDocument::QTextDocument(const QString &text, QObject *parent = nullptr)
Crée un objet `QTextDocument` contenant le texte brut (non formaté) ` text ` spécifié, ainsi que l'parent` indiquée.
[virtual noexcept] QTextDocument::~QTextDocument()
Détruit le document.
void QTextDocument::addResource(int type, const QUrl &name, const QVariant &resource)
Ajoute la ressource resource au cache de ressources, en utilisant type et name comme identifiants. type doit être une valeur issue de QTextDocument::ResourceType.
Par exemple, vous pouvez ajouter une image en tant que ressource afin de la référencer depuis le document :
document->addResource(QTextDocument::ImageResource,
QUrl("mydata://image.png"), QVariant(image));L'image peut être insérée dans le document à l'aide de l'API QTextCursor:
QTextImageFormat imageFormat;
imageFormat.setName("mydata://image.png");
cursor.insertImage(imageFormat);Vous pouvez également insérer des images à l’aide de la balise HTML img:
editor->append("<img src=\"mydata://image.png\" />");void QTextDocument::adjustSize()
Permet d'ajuster la taille du document à une taille raisonnable.
Voir également idealWidth(), textWidth et size.
QList<QTextFormat> QTextDocument::allFormats() const
Renvoie une liste des formats de texte correspondant à tous les formats utilisés dans le document.
int QTextDocument::availableRedoSteps() const
Renvoie le nombre d'étapes de redo disponibles.
Voir aussi isRedoAvailable().
int QTextDocument::availableUndoSteps() const
Renvoie le nombre d'étapes d'annulation disponibles.
Voir également la fonction « isUndoAvailable() ».
[since 6.0] qreal QTextDocument::baselineOffset() const
Renvoie le décalage de la ligne de base en %, utilisé dans la mise en page du document.
Cette fonction a été introduite dans Qt 6.0.
Voir également setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().
QTextBlock QTextDocument::begin() const
Renvoie le premier bloc de texte du document.
Voir également firstBlock().
[signal] void QTextDocument::blockCountChanged(int newBlockCount)
Ce signal est émis lorsque le nombre total de blocs de texte dans le document change. La valeur transmise à ` newBlockCount ` correspond au nouveau total.
QChar QTextDocument::characterAt(int pos) const
Renvoie le caractère situé à la position pos, ou un caractère nul si la position est hors limites.
Voir aussi characterCount().
int QTextDocument::characterCount() const
Renvoie le nombre de caractères de ce document.
Remarque : comme un objet ` QTextDocument ` contient toujours au moins un ` QChar::ParagraphSeparator`, cette méthode renvoie au moins 1.
Voir aussi blockCount() et characterAt().
[virtual] void QTextDocument::clear()
Efface le document.
void QTextDocument::clearUndoRedoStacks(QTextDocument::Stacks stacksToClear = UndoAndRedoStacks)
Efface les piles spécifiées par ` stacksToClear`.
Cette méthode efface toutes les commandes présentes dans la pile d’annulation, la pile de rétablissement, ou les deux (par défaut). Si des commandes sont effacées, les signaux appropriés sont émis : QTextDocument::undoAvailable() ou QTextDocument::redoAvailable().
Voir également QTextDocument::undoAvailable() et QTextDocument::redoAvailable().
QTextDocument *QTextDocument::clone(QObject *parent = nullptr) const
Crée un nouvel objet ` QTextDocument ` qui est une copie de ce document texte. ` parent ` est le parent du document texte renvoyé.
[signal] void QTextDocument::contentsChange(int position, int charsRemoved, int charsAdded)
Ce signal est émis chaque fois que le contenu du document change ; par exemple, lorsqu'un texte est inséré ou supprimé, ou lorsqu'une mise en forme est appliquée.
Des informations sont fournies concernant l’ position e du caractère dans le document où la modification s’est produite, le nombre de caractères supprimés (charsRemoved) et le nombre de caractères ajoutés (charsAdded).
Le signal est émis avant que le gestionnaire de mise en page du document ne soit informé de la modification. Ce hook vous permet d’implémenter la coloration syntaxique pour le document.
Voir également QAbstractTextDocumentLayout::documentChanged() et contentsChanged().
[signal] void QTextDocument::contentsChanged()
Ce signal est émis chaque fois que le contenu du document change ; par exemple, lorsqu'on insère ou supprime du texte, ou lorsqu'on applique une mise en forme.
Voir également contentsChange().
[virtual protected] QTextObject *QTextDocument::createObject(const QTextFormat &format)
Crée et renvoie un nouvel objet document (un ` QTextObject`), à partir de l’ format fourni.
Les objets QTextObject sont toujours créés via cette méthode ; vous devez donc la réimplémenter si vous utilisez des objets texte personnalisés dans votre document.
[signal] void QTextDocument::cursorPositionChanged(const QTextCursor &cursor)
Ce signal est émis chaque fois que la position d'un curseur change à la suite d'une opération d'édition. Le curseur dont la position a changé est transmis via ` cursor`. Si le document est utilisé avec la classe ` QTextEdit ` et que vous avez besoin d'un signal lorsque le curseur est déplacé à l'aide des touches fléchées, vous pouvez utiliser le signal ` cursorPositionChanged()` dans ` QTextEdit`.
Qt::CursorMoveStyle QTextDocument::defaultCursorMoveStyle() const
Le style de déplacement du curseur par défaut est utilisé par tous les objets QTextCursor créés à partir du document. La valeur par défaut est Qt::LogicalMoveStyle.
Voir également setDefaultCursorMoveStyle().
QFont QTextDocument::defaultFont() const
Renvoie la police par défaut à utiliser dans la mise en page du document.
Remarque : fonctiongetter pour la propriété defaultFont.
Voir aussi setDefaultFont().
[static, since 6.1] QTextDocument::ResourceProvider QTextDocument::defaultResourceProvider()
Renvoie le fournisseur de ressources par défaut.
Cette fonction a été introduite dans Qt 6.1.
Voir également setDefaultResourceProvider(), resourceProvider() et loadResource().
QTextOption QTextDocument::defaultTextOption() const
L'option de texte par défaut s'applique à tous les objets « QTextLayout » du document. Cela permet de définir des propriétés globales pour le document, telles que le mode de retour à la ligne par défaut.
Remarque : fonctiongetter pour la propriété defaultTextOption.
Voir également setDefaultTextOption().
QAbstractTextDocumentLayout *QTextDocument::documentLayout() const
Renvoie la mise en page de ce document.
Voir également setDocumentLayout().
[signal] void QTextDocument::documentLayoutChanged()
Ce signal est émis lorsqu'une nouvelle mise en page est définie.
Voir également setDocumentLayout().
void QTextDocument::drawContents(QPainter *p, const QRectF &rect = QRectF())
Dessine le contenu du document à l'aide de l'p « painter », en le limitant à l' « rect ». Si l' « rect » est un rectangle nul (par défaut), le document est alors dessiné sans limitation.
QTextBlock QTextDocument::end() const
Cette fonction renvoie un bloc permettant de vérifier si l'on a atteint la fin du document lors d'une itération sur celui-ci.
for (QTextBlock it = doc->begin(); it != doc->end(); it = it.next())
std::cout << it.text().toStdString() << "\n";Le bloc renvoyé n'est pas valide et correspond au bloc situé après le dernier bloc du document. Vous pouvez utiliser la fonction lastBlock() pour récupérer le dernier bloc valide du document.
Voir également lastBlock().
QTextCursor QTextDocument::find(const QRegularExpression &expr, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const
Recherche la prochaine occurrence correspondant à l'expression régulière donnée, expr, au sein du même paragraphe du document.
La recherche commence à la position de l’ cursor on fournie et se poursuit vers l’avant dans le document, sauf indication contraire dans les options de recherche. Les options de recherche ( options ) déterminent le type de recherche effectué.
Renvoie un curseur avec la correspondance sélectionnée si une correspondance a été trouvée ; sinon, renvoie un curseur nul.
Si l'cursor spécifiée comporte une sélection, la recherche commence après la sélection ; sinon, elle commence à la position du curseur.
Par défaut, la recherche n’est pas sensible à la casse et peut trouver du texte n’importe où dans le document.
QTextCursor QTextDocument::find(const QRegularExpression &expr, int from = 0, QTextDocument::FindFlags options = FindFlags()) const
Recherche la prochaine occurrence correspondant à l'expression régulière donnée, expr, au sein du même paragraphe du document.
La recherche commence à la position indiquée par ` from ` et se poursuit vers l'avant dans le document, sauf indication contraire dans les options de recherche. Les ` options ` déterminent le type de recherche effectué.
Renvoie un curseur avec le résultat sélectionné si une correspondance a été trouvée ; sinon, renvoie un curseur nul.
Si la position from est égale à 0 (valeur par défaut), la recherche commence au début du document ; sinon, elle commence à la position spécifiée.
Avertissement : pour des raisons historiques, l'option de sensibilité à la casse définie sur ` expr ` est ignorée. Ce sont plutôt les paramètres ` options ` qui sont utilisés pour déterminer si la recherche tient compte de la casse ou non.
QTextCursor QTextDocument::find(const QString &subString, const QTextCursor &cursor, QTextDocument::FindFlags options = FindFlags()) const
Recherche la prochaine occurrence de la chaîne « subString » dans le document. La recherche commence à la position indiquée par « cursor » et se poursuit vers l’avant dans le document, sauf indication contraire dans les options de recherche. Les paramètres « options » déterminent le type de recherche effectuée.
Renvoie un curseur avec la correspondance sélectionnée si subString a été trouvé ; sinon, renvoie un curseur nul.
Si l'cursor on fournie comporte une sélection, la recherche commence après celle-ci ; sinon, elle commence à la position du curseur.
Par défaut, la recherche est insensible à la casse et peut trouver du texte n'importe où dans le document.
QTextCursor QTextDocument::find(const QString &subString, int position = 0, QTextDocument::FindFlags options = FindFlags()) const
Recherche la prochaine occurrence de la chaîne « subString » dans le document. La recherche commence à l’ position indiquée et se poursuit vers l’avant dans le document, sauf indication contraire dans les options de recherche. Les paramètres « options » déterminent le type de recherche effectuée.
Renvoie un curseur avec la correspondance sélectionnée si subString a été trouvé ; sinon, renvoie un curseur nul.
Si l’ position est égal à 0 (valeur par défaut), la recherche commence au début du document ; sinon, elle commence à la position spécifiée.
Il s’agit d’une fonction surchargée.
QTextBlock QTextDocument::findBlock(int pos) const
Renvoie le bloc de texte contenant le -ième caractère de « pos ».
QTextBlock QTextDocument::findBlockByLineNumber(int lineNumber) const
Renvoie le bloc de texte contenant le texte spécifié lineNumber.
Voir aussi QTextBlock::firstLineNumber().
QTextBlock QTextDocument::findBlockByNumber(int blockNumber) const
Renvoie le bloc de texte avec l'blockNumber spécifiée.
Voir aussi ` QTextBlock::blockNumber()`.
QTextBlock QTextDocument::firstBlock() const
Renvoie le premier bloc de texte du document.
qreal QTextDocument::idealWidth() const
Renvoie la largeur idéale du document texte. La largeur idéale correspond à la largeur effectivement utilisée par le document, sans tenir compte des alignements facultatifs. Elle est toujours inférieure ou égale à la valeur renvoyée par la fonction ` size()`.width().
Voir également adjustSize() et textWidth.
bool QTextDocument::isEmpty() const
Renvoie « true » si le document est vide ; sinon, renvoie « false ».
bool QTextDocument::isRedoAvailable() const
Renvoie « true » si la fonction « redo » est disponible ; sinon, renvoie « false ».
Voir également isUndoAvailable() et availableRedoSteps().
bool QTextDocument::isUndoAvailable() const
Renvoie « true » si la fonction « undo » est disponible ; sinon, renvoie « false ».
Voir également isRedoAvailable() et availableUndoSteps().
QTextBlock QTextDocument::lastBlock() const
Renvoie le dernier bloc de texte (valide) du document.
int QTextDocument::lineCount() const
Renvoie le nombre de lignes de ce document (si la mise en page le permet). Sinon, cette valeur correspond au nombre de blocs.
Voir également blockCount() et characterCount().
[virtual protected invokable] QVariant QTextDocument::loadResource(int type, const QUrl &name)
Charge les données de l'type spécifiée à partir de la ressource dont l'name est indiquée.
Cette fonction est appelée par le moteur de texte enrichi pour demander des données qui ne sont pas directement stockées par ` QTextDocument`, mais qui lui sont néanmoins associées. Par exemple, les images sont référencées indirectement par l’attribut `name` d’un objet ` QTextImageFormat `.
Lorsqu’elle est appelée par Qt, ` type ` est l’une des valeurs de ` QTextDocument::ResourceType`.
Si ` QTextDocument ` est un objet enfant d’un ` QObject ` disposant d’une méthode `loadResource` invocable, telle que ` QTextEdit`, ` QTextBrowser ` ou ` QTextDocument ` elle-même, l’implémentation par défaut tente alors de récupérer les données auprès du parent.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également QTextDocument::ResourceProvider.
void QTextDocument::markContentsDirty(int position, int length)
Marque comme « modifiés » les contenus spécifiés par les attributs position et length, indiquant ainsi au document qu'il doit être réorganisé.
QString QTextDocument::metaInformation(QTextDocument::MetaInformation info) const
Renvoie des méta-informations sur le document du type spécifié par info.
Voir également setMetaInformation().
[signal] void QTextDocument::modificationChanged(bool changed)
Ce signal est émis chaque fois que le contenu du document subit une modification qui affecte son état de modification. Si la valeur de ` changed ` est `true`, le document a été modifié ; dans le cas contraire, elle est `false`.
Par exemple, si l’on appelle la méthode ` setModified(false)` sur un document puis que l’on insère du texte, le signal est émis. Si l’on annule cette opération, ce qui ramène le document à son état d’origine non modifié, le signal est à nouveau émis.
QTextObject *QTextDocument::object(int objectIndex) const
Renvoie l'objet texte associé à l'objectIndex donné.
QTextObject *QTextDocument::objectForFormat(const QTextFormat &f) const
Renvoie l'objet texte associé au format f.
int QTextDocument::pageCount() const
renvoie le nombre de pages de ce document.
void QTextDocument::print(QPagedPaintDevice *printer) const
Imprime le document sur l'printer spécifiée. L'QPagedPaintDevice doit être configurée avant d'être utilisée avec cette fonction.
Il s’agit simplement d’une méthode pratique permettant d’imprimer l’intégralité du document sur l’imprimante.
Si le document est déjà paginé selon une hauteur spécifiée dans la propriété pageSize(), il est imprimé tel quel.
Si le document n’est pas paginé, comme c’est le cas par exemple pour un document utilisé dans un ` QTextEdit`, une copie temporaire du document est alors créée et cette copie est divisée en plusieurs pages en fonction de la taille du `paperRect()` du périphérique d’impression. Par défaut, une marge de 2 cm est définie autour du contenu du document. De plus, le numéro de la page en cours est imprimé au bas de chaque page.
Voir également QTextEdit::print().
void QTextDocument::redo(QTextCursor *cursor)
Répète la dernière opération d'édition effectuée sur le document si redo is available.
L'cursor fourni est positionné à la fin de l'emplacement où l'opération d'édition a été refaite.
[slot] void QTextDocument::redo()
Répète la dernière opération d'édition effectuée sur le document si redo is available.
Remarque : ce slot est surchargé. Pour vous connecter à ce slot :
// Connect using qOverload:
connect(sender, &SenderClass::signal,
textDocument, qOverload<>(&QTextDocument::redo));
// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
textDocument, [receiver = textDocument]() { receiver->redo(); });[signal] void QTextDocument::redoAvailable(bool available)
Ce signal est émis dès que les opérations de réexécution deviennent disponibles (available est vrai) ou indisponibles (available est faux).
QVariant QTextDocument::resource(int type, const QUrl &name) const
Renvoie les données de l'type spécifié à partir de la ressource dont l'name est indiquée.
Cette fonction est appelée par le moteur de texte enrichi pour demander des données qui ne sont pas directement stockées par QTextDocument, mais qui lui sont néanmoins associées. Par exemple, les images sont référencées indirectement par l’attribut « name » d’un objet QTextImageFormat.
Les ressources sont mises en cache en interne dans le document. Si une ressource est introuvable dans le cache, la méthode ` loadResource ` est appelée pour tenter de la charger. ` loadResource ` doit alors utiliser ` addResource ` pour ajouter la ressource au cache.
Si la méthode ` loadResource ` ne parvient pas à charger la ressource, la méthode ` resourceProvider `, puis enfin la méthode ` defaultResourceProvider ` seront appelées, si elles sont définies. Notez que le résultat fourni par le fournisseur ne sera pas ajouté automatiquement au cache.
Voir également QTextDocument::ResourceType et resourceProvider().
[since 6.1] QTextDocument::ResourceProvider QTextDocument::resourceProvider() const
Renvoie le fournisseur de ressources associé à ce document texte.
Cette fonction a été introduite dans Qt 6.1.
Voir également setResourceProvider(), defaultResourceProvider() et loadResource().
int QTextDocument::revision() const
Renvoie la révision du document (si la fonction « Annuler » est activée).
La révision augmente systématiquement lorsqu’un document non modifié est édité.
Voir également QTextBlock::revision() et isModified().
QTextFrame *QTextDocument::rootFrame() const
Renvoie le cadre racine du document.
[since 6.0] void QTextDocument::setBaselineOffset(qreal baseline)
Définit la ligne de base en pourcentage de la hauteur de la police à utiliser dans la mise en page du document, selon la méthode « baseline ». La valeur par défaut est 0. Une valeur positive déplace le texte vers le haut, du pourcentage correspondant ; une valeur négative le déplace vers le bas.
Cette fonction a été introduite dans Qt 6.0.
Voir également baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().
void QTextDocument::setDefaultCursorMoveStyle(Qt::CursorMoveStyle style)
Définit le style de déplacement par défaut du curseur sur la valeur indiquée : style.
Voir aussi defaultCursorMoveStyle().
void QTextDocument::setDefaultFont(const QFont &font)
Définit l'font par défaut à utiliser dans la mise en page du document.
Remarque : fonctionde définition de la propriété defaultFont.
Voir aussi defaultFont().
[static, since 6.1] void QTextDocument::setDefaultResourceProvider(const QTextDocument::ResourceProvider &provider)
Définit le fournisseur de ressources par défaut sur provider.
Le fournisseur par défaut sera utilisé par tous les QTextDocuments pour lesquels aucun fournisseur n'a été explicitement défini.
Cette fonction a été introduite dans Qt 6.1.
Voir également defaultResourceProvider(), setResourceProvider() et loadResource().
void QTextDocument::setDefaultTextOption(const QTextOption &option)
Définit l'option de texte par défaut sur « option ».
Remarque : fonctionde définition de la propriété defaultTextOption.
Voir aussi defaultTextOption().
void QTextDocument::setDocumentLayout(QAbstractTextDocumentLayout *layout)
Configure le document pour qu'il utilise la mise en page spécifiée layout. La mise en page précédente est supprimée.
Voir également documentLayoutChanged().
void QTextDocument::setHtml(const QString &html)
Remplace tout le contenu du document par le texte au format HTML fourni dans la chaîne « html ». L'historique des annulations et des reprises est réinitialisé lorsque cette fonction est appelée.
La mise en forme HTML est respectée autant que possible ; par exemple, « <b>bold</b> text » produira un texte dans lequel le premier mot aura une épaisseur de police lui donnant un aspect gras : «bold text ».
Pour sélectionner une règle CSS « media » autre que la règle par défaut « screen », utilisez setMetaInformation() avec «CssMedia » comme paramètre « info ».
Remarque : il incombe à l’appelant de s’assurer que le texte est correctement décodé lorsqu’un QString contenant du code HTML est créé et transmis à la fonction setHtml().
Voir également setPlainText(), Sous-ensemble HTML pris en charge et setMetaInformation().
void QTextDocument::setIndentWidth(qreal width)
Définit la valeur « width » utilisée pour l’indentation des listes de texte et des blocs de texte.
Les propriétés d'indentation de « QTextListFormat » et « QTextBlockFormat » spécifient des multiples de cette valeur. La largeur d'indentation par défaut est de 40.
Remarque : fonctionde définition de la propriété indentWidth.
Voir aussi indentWidth().
void QTextDocument::setMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub)
Remplace l'intégralité du contenu du document par le texte au format Markdown fourni dans la chaîne « markdown », en prenant en charge les options « features » indiquées. Par défaut, toutes les fonctionnalités Markdown de type GitHub prises en charge sont incluses ; passez « MarkdownDialectCommonMark » pour une analyse plus basique.
La mise en forme Markdown est respectée autant que possible ; par exemple, « *texte en gras* » produira un texte dans lequel le premier mot aura une épaisseur de police lui donnant un aspect mis en évidence.
L’analyse du code HTML inclus dans la chaîne « markdown » est gérée de la même manière que dans « setHtml » ; toutefois, la mise en forme Markdown à l’intérieur des blocs HTML n’est pas prise en charge.
Certaines fonctionnalités de l’analyseur peuvent être activées ou désactivées via l’argument features. La valeur par défaut est MarkdownDialectGitHub.
L'historique des annulations et des reprises est réinitialisé lorsque cette fonction est appelée.
void QTextDocument::setMetaInformation(QTextDocument::MetaInformation info, const QString &string)
Définit les métadonnées du document, dont le type est spécifié par ` info `, sur la valeur fournie par ` string`.
Voir également metaInformation().
void QTextDocument::setPlainText(const QString &text)
Remplace l'intégralité du contenu du document par le texte brut fourni text. L'historique des annulations et des reprises est réinitialisé lorsque cette fonction est appelée.
Voir aussi setHtml().
[since 6.1] void QTextDocument::setResourceProvider(const QTextDocument::ResourceProvider &provider)
Définit le fournisseur de ressources du document texte sur provider.
Cette fonction a été introduite dans Qt 6.1.
Voir également resourceProvider() et loadResource().
[since 6.0] void QTextDocument::setSubScriptBaseline(qreal baseline)
Définit la ligne de base par défaut des indices, exprimée en pourcentage de la hauteur de la police, à utiliser dans la mise en page du document, à l'adresse baseline. La valeur par défaut est de 16,67 % (1/6 de la hauteur).
Cette fonction a été introduite dans Qt 6.0.
Voir également subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().
[since 6.0] void QTextDocument::setSuperScriptBaseline(qreal baseline)
Définit la ligne de base par défaut des exposants sous forme de pourcentage de la hauteur de la police, à utiliser dans la mise en page du document : baseline. La valeur par défaut est 50 % (la moitié de la hauteur).
Cette fonction a été introduite dans Qt 6.0.
Voir également superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().
[since 6.0] qreal QTextDocument::subScriptBaseline() const
Renvoie la ligne de base de l'exposant sous forme de pourcentage de la hauteur de police utilisée dans la mise en page du document.
Cette fonction a été introduite dans Qt 6.0.
Voir également setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().
[since 6.0] qreal QTextDocument::superScriptBaseline() const
Renvoie la ligne de base de l'exposant sous forme de pourcentage de la hauteur de police utilisée dans la mise en page du document.
Cette fonction a été introduite dans Qt 6.0.
Voir également setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().
QString QTextDocument::toHtml() const
Renvoie une chaîne contenant une représentation HTML du document.
Le contenu du document spécifie que son encodage est UTF-8. Si vous convertissez ultérieurement la chaîne HTML renvoyée en tableau d'octets pour la transmettre sur un réseau ou pour l'enregistrer sur le disque, vous devez utiliser la fonction ` QString::toUtf8()` pour convertir la chaîne en ` QByteArray`.
Voir également «Sous-ensemble HTML pris en charge ».
QString QTextDocument::toMarkdown(QTextDocument::MarkdownFeatures features = MarkdownDialectGitHub) const
Renvoie une chaîne contenant une représentation Markdown du document avec l'features spécifiée, ou une chaîne vide si l'écriture échoue pour une raison quelconque.
Voir également setMarkdown.
QString QTextDocument::toPlainText() const
Renvoie le texte brut contenu dans le document. Si vous souhaitez obtenir les informations de mise en forme, utilisez plutôt la fonction ` QTextCursor `.
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 la fonction toRawText().
Remarque : les objetsintégrés , tels que les images, sont représentés par la valeur Unicode U+FFFC (CARACTÈRE DE REMPLACEMENT D'OBJET).
Voir également toHtml().
QString QTextDocument::toRawText() const
Renvoie le texte brut contenu dans le document, sans aucune information de mise en forme. Si vous souhaitez obtenir des informations de mise en forme, utilisez plutôt la fonction « QTextCursor ».
Voir également toPlainText().
void QTextDocument::undo(QTextCursor *cursor)
Annule la dernière opération d'édition effectuée sur le document, si la fonction d'annulation est disponible. L'cursor fourni est positionné à la fin de l'emplacement où l'opération d'édition a été annulée.
Pour plus de détails, consultez la documentation du framework Qt Undo.
Voir également ` undoAvailable()` et ` isUndoRedoEnabled()`.
[slot] void QTextDocument::undo()
Remarque : cet emplacement est surchargé. Pour vous connecter à cet emplacement :
// Connect using qOverload:
connect(sender, &SenderClass::signal,
textDocument, qOverload<>(&QTextDocument::undo));
// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
textDocument, [receiver = textDocument]() { receiver->undo(); });[signal] void QTextDocument::undoAvailable(bool available)
Ce signal est émis dès que les opérations d'annulation deviennent disponibles (available est vrai) ou indisponibles (available est faux).
Pour plus de détails, consultez la documentation du framework Qt Undo.
Voir également undo() et isUndoRedoEnabled().
[signal] void QTextDocument::undoCommandAdded()
Ce signal est émis chaque fois qu'un nouveau niveau d'annulation est ajouté à l'QTextDocument.
© 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.