QQuickTextDocument Class
La classe `QQuickTextDocument` permet d'accéder à l'QTextDocument e de `QQuickTextEdit`. En savoir plus...
| En-tête : | #include <QQuickTextDocument> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| En QML : | TextDocument |
| Hérite de : | QObject |
Propriétés
(technology preview)errorString : QString(technology preview)modified : bool(technology preview)source : QUrl(technology preview)status : Status
Fonctions publiques
| QQuickTextDocument(QQuickItem *parent) | |
| QString | errorString() const |
| bool | isModified() const |
(technology preview) void | save() |
(technology preview) void | saveAs(const QUrl &url) |
| void | setModified(bool modified) |
| void | setSource(const QUrl &url) |
(since 6.7) void | setTextDocument(QTextDocument *document) |
| QUrl | source() const |
| QQuickTextDocument::Status | status() const |
| QTextDocument * | textDocument() const |
Signaux
(technology preview) void | errorStringChanged() |
(technology preview) void | modifiedChanged() |
(technology preview) void | sourceChanged() |
(technology preview) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
Description détaillée
Cette classe permet d'accéder à l'QTextDocument des éléments QQuickTextEdit. Elle est fournie pour permettre l'utilisation des fonctionnalités de traitement de texte enrichi de Qt, y compris les modifications de documents. Elle peut également être utilisée pour générer du contenu, par exemple avec QTextDocumentWriter, ou pour appliquer une mise en forme supplémentaire, par exemple avec QSyntaxHighlighter.
Documentation des propriétés
[read-only, technology preview] errorString : QString
Cette énumération est en phase de préversion technique et est susceptible d'être modifiée.
Cette propriété contient une chaîne de caractères lisible par l'utilisateur décrivant l'erreur survenue lors du chargement ou de l'enregistrement, le cas échéant
Par défaut, cette chaîne est vide.
Cette énumération a été introduite dans Qt 6.7.
Fonctions d'accès :
| QString | errorString() const |
Signal de notification :
| void | errorStringChanged() |
Voir également status, source, save() et saveAs().
[technology preview] modified : bool
Cette énumération est en phase de préversion technique et est susceptible d'être modifiée.
Cette propriété indique si le document a été modifié par l'utilisateur
Cette propriété indique si le document a été modifié par l’utilisateur depuis son dernier chargement ou enregistrement. Par défaut, cette propriété est définie sur « false ».
Comme pour « QTextDocument::modified », vous pouvez définir la propriété « modified » : par exemple, définissez-la sur « false » pour permettre de définir la propriété « source » sur une URL différente (ce qui annule les modifications apportées par l'utilisateur).
Cette énumération a été introduite dans Qt 6.7.
Fonctions d’accès :
| bool | isModified() const |
| void | setModified(bool modified) |
Signal Notifier :
| void | modifiedChanged() |
Voir également QTextDocument::modified.
[technology preview] source : QUrl
Cette énumération est en phase de préversion technique et est susceptible d'être modifiée.
Cette propriété contient l'URL à partir de laquelle charger le contenu du document
QQuickTextDocument peut prendre en charge n'importe quel format de texte pris en charge par Qt, chargé à partir de n'importe quel schéma d'URL pris en charge par Qt.
La propriété ` source ` ne peut pas être modifiée tant que l'état de l'modified du document est ` true`. Si l'utilisateur a modifié le contenu du document, vous devez lui demander s'il souhaite ` save()` ou bien ignorer les modifications en définissant ` modified ` sur ` false ` avant de définir la propriété ` source ` sur une autre URL.
Cette énumération a été introduite dans Qt 6.7.
Fonctions d’accès :
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Signal de notification :
| void | sourceChanged() |
Voir également QTextDocumentWriter::supportedDocumentFormats().
[read-only, technology preview] status : Status
Cette énumération est en phase de préversion technique et est susceptible d'être modifiée.
Cette propriété contient l'état de chargement ou d'enregistrement du document
Cette propriété indique l'état du chargement ou de l'enregistrement du document. Elle peut prendre l'une des valeurs suivantes :
| Constante | Description |
|---|---|
Null | Aucun fichier n'a été chargé |
Loading | La lecture à partir de source a commencé |
Loaded | La lecture s'est terminée avec succès |
Saving | L'écriture du fichier a commencé après l'appel de save() ou saveAs() |
Saved | L'écriture s'est terminée avec succès |
ReadError | Une erreur s'est produite lors de la lecture à partir de source |
WriteError | Une erreur s'est produite dans save() ou saveAs() |
NonLocalFileError | saveAs() a été appelée avec une URL pointant vers une ressource distante plutôt que vers un fichier local |
Cette énumération a été introduite dans Qt 6.7.
Fonctions d'accès :
| QQuickTextDocument::Status | status() const |
Signal de notification :
| void | statusChanged() |
Voir également errorString, source, save() et saveAs().
Documentation des fonctions membres
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
Crée un objet `QQuickTextDocument` dont l'objet parent est ` parent `.
[signal, technology preview] void QQuickTextDocument::errorStringChanged()
Cette fonctionnalité est en phase de préversion technique et est susceptible d'évoluer.
Remarque : signalde notification pour la propriété errorString.
[signal, technology preview] void QQuickTextDocument::modifiedChanged()
Cette fonctionnalité est en phase de préversion technique et est susceptible d'être modifiée.
Remarque : signalde notification pour la propriété modified.
[invokable, technology preview] void QQuickTextDocument::save()
Cette fonctionnalité est en phase de préversion technique et est susceptible d'être modifiée.
Enregistre le contenu dans le même fichier et au même format que ceux spécifiés par source.
Remarque : vous pouvez enregistrer dans un fichier local ou, sous Android, vers une URL content.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Cette fonction a été introduite dans Qt 6.7.
Voir également source et saveAs().
[invokable, technology preview] void QQuickTextDocument::saveAs(const QUrl &url)
Cette fonctionnalité est en phase de prévisualisation technique et est susceptible d'être modifiée.
Enregistre le contenu dans le fichier et au format spécifiés par url.
L’extension de fichier indiquée dans ` url ` spécifie le format de fichier (tel que déterminé par ` QMimeDatabase::mimeTypeForUrl()`).
Remarque : vous pouvez enregistrer dans un fichier local ou, sous Android, à une URL content.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Cette fonction a été introduite dans Qt 6.7.
Voir également source et save().
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
Définit l'document spécifiée.
L'appelant conserve la propriété du document.
Cette fonction a été introduite dans Qt 6.7.
Voir également textDocument().
[signal, technology preview] void QQuickTextDocument::sourceChanged()
Cette fonctionnalité est en phase de préversion technique et est susceptible d'évoluer.
Remarque : signalde notification pour la propriété source.
[signal, technology preview] void QQuickTextDocument::statusChanged()
Cette fonction est en phase de préversion technique et est susceptible d'être modifiée.
Remarque : signalde notification pour la propriété status.
QTextDocument *QQuickTextDocument::textDocument() const
Renvoie un pointeur vers l'objet ` QTextDocument `.
Voir aussi setTextDocument().
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
Ce signal est émis lorsque l'QTextDocument e sous-jacente est remplacée par une autre instance.
Cette fonction a été introduite dans Qt 6.7.
Voir également setTextDocument().
© 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.
