QQuickTextDocument Class
Die Klasse „QQuickTextDocument“ ermöglicht den Zugriff auf das „ QTextDocument “ von „QQuickTextEdit“. Mehr...
| Header: | #include <QQuickTextDocument> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| In QML: | TextDocument |
| Erbt von: | QObject |
Eigenschaften
(technology preview)errorString : QString(technology preview)modified : bool(technology preview)source : QUrl(technology preview)status : Status
Öffentliche Funktionen
| 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 |
Signale
(technology preview) void | errorStringChanged() |
(technology preview) void | modifiedChanged() |
(technology preview) void | sourceChanged() |
(technology preview) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
Ausführliche Beschreibung
Diese Klasse bietet Zugriff auf die „ QTextDocument “ von QQuickTextEdit-Elementen. Dies ermöglicht die Nutzung der Rich-Text-Verarbeitungsfunktionen von Qt, einschließlich Dokumentänderungen. Sie kann auch zur Ausgabe von Inhalten verwendet werden, beispielsweise mit ` QTextDocumentWriter`, oder zur Bereitstellung zusätzlicher Formatierungen, beispielsweise mit ` QSyntaxHighlighter`.
Dokumentation zu den Eigenschaften
[read-only, technology preview] errorString : QString
Diese Aufzählung befindet sich in der Technology Preview und kann sich noch ändern.
Diese Eigenschaft enthält eine für Menschen lesbare Zeichenfolge, die den Fehler beschreibt, der beim Laden oder Speichern aufgetreten ist, falls vorhanden
Standardmäßig ist diese Zeichenkette leer.
Diese Aufzählung wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QString | errorString() const |
Notifier-Signal:
| void | errorStringChanged() |
Siehe auch „ status“ , „ source “, „ save()“ und „ saveAs()“.
[technology preview] modified : bool
Diese Aufzählung befindet sich in der Technology Preview und kann sich noch ändern.
Diese Eigenschaft gibt an, ob das Dokument vom Benutzer geändert wurde
Diese Eigenschaft gibt an, ob das Dokument seit dem letzten Laden oder Speichern vom Benutzer geändert wurde. Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.
Wie bei „ QTextDocument::modified “ können Sie die Eigenschaft „modified“ festlegen: Setzen Sie sie beispielsweise auf „ false “, um die Eigenschaft „ source “ auf eine andere URL zu setzen (wodurch die Änderungen des Benutzers verworfen werden).
Diese Enumeration wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| bool | isModified() const |
| void | setModified(bool modified) |
Notifier-Signal:
| void | modifiedChanged() |
Siehe auch QTextDocument::modified.
[technology preview] source : QUrl
Diese Aufzählung befindet sich in der Technologievorschau und kann sich noch ändern.
Diese Eigenschaft enthält die URL, von der der Dokumentinhalt geladen werden soll
QQuickTextDocument kann jedes von Qt unterstützte Textformat verarbeiten, das über jedes von Qt unterstützte URL-Schema geladen wird.
Die Eigenschaft „ source “ kann nicht geändert werden, solange sich der Status „ modified “ des Dokuments auf „ true “ befindet. Wenn der Benutzer den Dokumentinhalt geändert hat, sollten Sie den Benutzer fragen, ob er „ save()“ ausführen möchte, oder andernfalls die Änderungen verwerfen, indem Sie „ modified “ auf „ false “ setzen, bevor Sie die Eigenschaft „ source “ auf eine andere URL setzen.
Diese Aufzählung wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Notifier-Signal:
| void | sourceChanged() |
Siehe auch „ QTextDocumentWriter::supportedDocumentFormats“ ().
[read-only, technology preview] status : Status
Diese Aufzählung befindet sich in der Technology Preview und kann sich noch ändern.
Diese Eigenschaft enthält den Status des Ladens oder Speicherns eines Dokuments
Diese Eigenschaft gibt den Status des Ladens oder Speicherns eines Dokuments an. Mögliche Werte sind:
| Konstante | Beschreibung |
|---|---|
Null | Es wurde keine Datei geladen |
Loading | Das Einlesen aus „ source “ hat begonnen |
Loaded | Das Lesen wurde erfolgreich abgeschlossen |
Saving | Das Schreiben der Datei wurde nach save() oder saveAs() gestartet |
Saved | Das Schreiben wurde erfolgreich abgeschlossen |
ReadError | Beim Lesen von ist ein Fehler aufgetreten source |
WriteError | Bei save() oder saveAs() ist ein Fehler aufgetreten |
NonLocalFileError | saveAs() wurde mit einer URL aufgerufen, die auf eine entfernte Ressource statt auf eine lokale Datei verweist |
Diese Enumeration wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QQuickTextDocument::Status | status() const |
Benachrichtigungssignal:
| void | statusChanged() |
Siehe auch errorString, source, save() und saveAs().
Dokumentation der Mitgliedsfunktionen
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
Erstellt ein `QQuickTextDocument`-Objekt mit ` parent ` als übergeordnetem Objekt.
[signal, technology preview] void QQuickTextDocument::errorStringChanged()
Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.
Hinweis: Notifier -Signal für die Eigenschaft „ errorString “.
[signal, technology preview] void QQuickTextDocument::modifiedChanged()
Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.
Hinweis: Notifier -Signal für die Eigenschaft „ modified “.
[invokable, technology preview] void QQuickTextDocument::save()
Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.
Speichert den Inhalt in derselben Datei und imselben Format, wie durch „ source “ angegeben.
Hinweis: Sie können in einer lokalen Datei oder unter Android unter einer content -URL speichern.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch source und saveAs().
[invokable, technology preview] void QQuickTextDocument::saveAs(const QUrl &url)
Diese Funktion befindet sich in der Technologievorschau und kann sich noch ändern.
Speichert den Inhalt in der Datei und im Format, die durch url angegeben sind.
Die Dateiendung in url gibt das Dateiformat an (wie durch QMimeDatabase::mimeTypeForUrl() festgelegt).
Hinweis: Sie können in einer lokalen Datei oder unter Android unter einer „ content “-URL speichern.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Diese Funktion wurde in Qt 6.7 eingeführt.
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
Setzt die angegebene „ document “.
Der Aufrufer behält das Eigentumsrecht an dem Dokument.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch textDocument().
[signal, technology preview] void QQuickTextDocument::sourceChanged()
Diese Funktion befindet sich in der Technology Preview und kann sich noch ändern.
Hinweis: Notifier -Signal für die Eigenschaft „ source “.
[signal, technology preview] void QQuickTextDocument::statusChanged()
Diese Funktion befindet sich in der Technology Preview und kann sich noch ändern.
Hinweis: Notifier -Signal für die Eigenschaft „ status “.
QTextDocument *QQuickTextDocument::textDocument() const
Gibt einen Zeiger auf das „ QTextDocument “-Objekt zurück.
Siehe auch ` setTextDocument()`.
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
Dieses Signal wird ausgelöst, wenn die zugrunde liegende Instanz ` QTextDocument ` durch eine andere Instanz ersetzt wird.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch 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.
