QQuickTextDocument Class
La classe QQuickTextDocument permet d'accéder au site QTextDocument de QQuickTextEdit. 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éritages : | QObject |
Propriétés
(preliminary)errorString : QString(preliminary)modified : bool(preliminary)source : QUrl(preliminary)status : Status
Fonctions publiques
| QQuickTextDocument(QQuickItem *parent) | |
| QString | errorString() const |
| bool | isModified() const |
(preliminary) void | save() |
(preliminary) 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
(preliminary) void | errorStringChanged() |
(preliminary) void | modifiedChanged() |
(preliminary) void | sourceChanged() |
(preliminary) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
Description détaillée
Cette classe permet d'accéder au site QTextDocument des éléments QQuickTextEdit. Elle permet d'utiliser les fonctionnalités de traitement de texte enrichi de Qt, y compris la modification de documents. Elle peut également être utilisée pour produire du contenu, par exemple avec QTextDocumentWriter, ou fournir un formatage supplémentaire, par exemple avec QSyntaxHighlighter.
Documentation sur les propriétés
[read-only, preliminary] errorString : QString
Cette propriété est en cours de développement et peut être modifiée.
Cette propriété contient une chaîne lisible par l'homme 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 propriété a été introduite dans Qt 6.7.
Fonctions d'accès :
| QString | errorString() const |
Signal Notifier :
| void | errorStringChanged() |
Voir aussi status, source, save(), et saveAs().
[preliminary] modified : bool
Cette propriété est en cours de développement et peut ê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 le dernier chargement ou enregistrement. Par défaut, cette propriété est false.
Comme pour QTextDocument::modified, vous pouvez définir la propriété modified : par exemple, définissez-la à false pour permettre de définir la propriété source à une URL différente (et donc d'ignorer les modifications apportées par l'utilisateur).
Cette propriété a été introduite dans Qt 6.7.
Fonctions d'accès :
| bool | isModified() const |
| void | setModified(bool modified) |
Signal Notifier :
| void | modifiedChanged() |
Voir aussi QTextDocument::modified.
[preliminary] source : QUrl
Cette propriété est en cours de développement et peut être modifiée.
Cette propriété contient l'URL à partir de laquelle le contenu du document doit être chargé
QQuickTextDocument peut gérer 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 du document modified est true. Si l'utilisateur a modifié le contenu du document, vous devez l'inviter à save(), ou à annuler les modifications en définissant modified à false avant de définir la propriété source à une URL différente.
Cette propriété a été introduite dans Qt 6.7.
Fonctions d'accès :
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Signal Notifier :
| void | sourceChanged() |
Voir aussi QTextDocumentWriter::supportedDocumentFormats().
[read-only, preliminary] status : Status
Cette propriété est en cours de développement et peut être modifiée.
Ce bien indique l'état du chargement ou de l'enregistrement d'un document
Cette propriété indique l'état du chargement ou de l'enregistrement du document. Elle peut être l'une des suivantes
| Constante | Description |
|---|---|
Null | Aucun fichier n'a été chargé |
Loading | La lecture de source a commencé |
Loaded | La lecture s'est terminée avec succès |
Saving | L'écriture du fichier a commencé après save() ou saveAs() |
Saved | L'écriture s'est terminée avec succès |
ReadError | Une erreur s'est produite lors de la lecture du fichier source |
WriteError | Une erreur s'est produite dans save() ou saveAs() |
NonLocalFileError | saveAs() a été appelé avec une URL pointant vers une ressource distante plutôt que vers un fichier local |
Cette propriété a été introduite dans Qt 6.7.
Fonctions d'accès :
| QQuickTextDocument::Status | status() const |
Signal Notifier :
| void | statusChanged() |
Voir aussi errorString, source, save(), et saveAs().
Documentation des fonctions membres
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
Construit un objet QQuickTextDocument avec parent comme objet parent.
[signal, preliminary] void QQuickTextDocument::errorStringChanged()
Cette fonction est en cours de développement et peut être modifiée.
Note : Signal de notification pour la propriété errorString.
[signal, preliminary] void QQuickTextDocument::modifiedChanged()
Cette fonction est en cours de développement et peut être modifiée.
Note : Signal de notification pour la propriété modified.
[invokable, preliminary] void QQuickTextDocument::save()
Cette fonction est en cours de développement et peut être modifiée.
Enregistre le contenu dans le même fichier et le même format que ceux spécifiés par source.
Remarque : Vous ne pouvez enregistrer que dans un fichier file on a mounted filesystem.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Cette fonction a été introduite dans Qt 6.7.
Voir également source et saveAs().
[invokable, preliminary] void QQuickTextDocument::saveAs(const QUrl &url)
Cette fonction est en cours de développement et peut être modifiée.
Enregistre le contenu dans le fichier et le format spécifiés par url.
L'extension du fichier dans url spécifie le format du fichier (tel que déterminé par QMimeDatabase::mimeTypeForUrl()).
Remarque : Vous ne pouvez enregistrer que dans un fichier file on a mounted filesystem.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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 le document document.
L'appelant reste propriétaire du document.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi textDocument().
[signal, preliminary] void QQuickTextDocument::sourceChanged()
Cette fonction est en cours de développement et peut être modifiée.
Note : Signal de notification pour la propriété source.
[signal, preliminary] void QQuickTextDocument::statusChanged()
Cette fonction est en cours de développement et peut être modifiée.
Note : Signal de notification pour la propriété status.
QTextDocument *QQuickTextDocument::textDocument() const
Renvoie un pointeur sur l'objet QTextDocument.
Voir aussi setTextDocument().
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
Ce signal est émis lorsque le site QTextDocument sous-jacent est remplacé par une instance différente.
Cette fonction a été introduite dans Qt 6.7.
Voir aussi 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.
