QQuickTextDocument Class
Die Klasse QQuickTextDocument bietet Zugriff auf die QTextDocument von QQuickTextEdit. Mehr...
| Kopfzeile: | #include <QQuickTextDocument> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| In QML: | TextDocument |
| Vererbt: | QObject |
Eigenschaften
(preliminary)errorString : const QString(preliminary)modified : bool(preliminary)source : QUrl(preliminary)status : const Status
Öffentliche Funktionen
| 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 |
Signale
(preliminary) void | errorStringChanged() |
(preliminary) void | modifiedChanged() |
(preliminary) void | sourceChanged() |
(preliminary) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
Detaillierte Beschreibung
Diese Klasse bietet Zugriff auf die QTextDocument von QQuickTextEdit-Elementen. Dies ermöglicht die Nutzung der Rich Text Processing Funktionalitäten von Qt, einschließlich der Änderung von Dokumenten. Sie kann auch verwendet werden, um Inhalte auszugeben, zum Beispiel mit QTextDocumentWriter, oder zusätzliche Formatierungen bereitzustellen, zum Beispiel mit QSyntaxHighlighter.
Eigenschaft Dokumentation
[read-only, preliminary] errorString : const QString
Diese Eigenschaft befindet sich in der Entwicklung und kann geändert werden.
Diese Eigenschaft enthält eine von Menschen lesbare Zeichenfolge, die den Fehler beschreibt, der beim Laden oder Speichern aufgetreten ist, falls ein solcher vorliegt
Standardmäßig ist diese Zeichenkette leer.
Diese Eigenschaft wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QString | errorString() const |
Notifier-Signal:
| void | errorStringChanged() |
Siehe auch status, source, save(), und saveAs().
[preliminary] modified : bool
Diese Eigenschaft befindet sich in der Entwicklung 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 durch den Benutzer geändert wurde. Standardmäßig steht diese Eigenschaft auf false.
Wie bei QTextDocument::modified können Sie die Eigenschaft modified einstellen: Setzen Sie sie zum Beispiel auf false, um die Eigenschaft source auf eine andere URL zu setzen (und damit die Änderungen des Benutzers zu verwerfen).
Diese Eigenschaft wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| bool | isModified() const |
| void | setModified(bool modified) |
Notifier-Signal:
| void | modifiedChanged() |
Siehe auch QTextDocument::modified.
[preliminary] source : QUrl
Diese Eigenschaft befindet sich in der Entwicklung und kann sich noch ändern.
Diese Eigenschaft enthält die URL, von der der Inhalt des Dokuments geladen werden soll
QQuickTextDocument kann jedes von Qt unterstützte Textformat verarbeiten, das von jedem von Qt unterstützten URL-Schema geladen wird.
Die Eigenschaft source kann nicht geändert werden, solange der Status des Dokuments modified true ist. Wenn der Benutzer den Inhalt des Dokuments geändert hat, sollten Sie den Benutzer auffordern, save() zu wählen oder die Änderungen zu verwerfen, indem Sie modified auf false setzen, bevor Sie die Eigenschaft source auf eine andere URL setzen.
Diese Eigenschaft 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, preliminary] status : const Status
Diese Eigenschaft befindet sich in der Entwicklung 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 des Dokuments an. Sie kann eine der folgenden sein:
| Konstant | Beschreibung |
|---|---|
Null | Es wurde noch keine Datei geladen |
Loading | Das Lesen von source hat begonnen |
Loaded | Das Lesen wurde erfolgreich beendet |
Saving | Das Schreiben der Datei hat nach save() oder saveAs() begonnen |
Saved | Das Schreiben wurde erfolgreich beendet |
ReadError | Es ist ein Fehler beim Lesen von source |
WriteError | In save() oder saveAs() ist ein Fehler aufgetreten |
NonLocalFileError | saveAs() wurde mit einer URL aufgerufen, die auf eine entfernte Ressource und nicht auf eine lokale Datei zeigt |
Diese Eigenschaft wurde in Qt 6.7 eingeführt.
Zugriffsfunktionen:
| QQuickTextDocument::Status | status() const |
Notifier-Signal:
| void | statusChanged() |
Siehe auch errorString, source, save(), und saveAs().
Dokumentation der Mitgliedsfunktionen
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
Konstruiert ein QQuickTextDocument-Objekt mit parent als übergeordnetem Objekt.
[signal, preliminary] void QQuickTextDocument::errorStringChanged()
Diese Funktion befindet sich in der Entwicklung und kann sich noch ändern.
Hinweis: Notifizierungssignal für die Eigenschaft errorString.
[signal, preliminary] void QQuickTextDocument::modifiedChanged()
Diese Funktion befindet sich in der Entwicklung und kann sich noch ändern.
Hinweis: Notifizierungssignal für die Eigenschaft modified.
[invokable, preliminary] void QQuickTextDocument::save()
Diese Funktion befindet sich in der Entwicklung und kann sich noch ändern.
Speichert den Inhalt in dieselbe Datei und dasselbe Format, die unter source angegeben sind.
Hinweis: Sie können nur in eine file on a mounted filesystem speichern.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch source und saveAs().
[invokable, preliminary] void QQuickTextDocument::saveAs(const QUrl &url)
Diese Funktion befindet sich in der Entwicklung und kann sich noch ändern.
Speichert den Inhalt in der Datei und dem Format, die durch url angegeben werden.
Die Dateierweiterung in url gibt das Dateiformat an (wie durch QMimeDatabase::mimeTypeForUrl() bestimmt).
Hinweis: Sie können nur in eine file on a mounted filesystem speichern.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Diese Funktion wurde in Qt 6.7 eingeführt.
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
Setzt das angegebene document.
Der Aufrufer behält das Eigentum an dem Dokument.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch textDocument().
[signal, preliminary] void QQuickTextDocument::sourceChanged()
Diese Funktion befindet sich in der Entwicklung und kann sich noch ändern.
Hinweis: Notifizierungssignal für die Eigenschaft source.
[signal, preliminary] void QQuickTextDocument::statusChanged()
Diese Funktion befindet sich in der Entwicklung und kann sich noch ändern.
Hinweis: Notifizierungssignal für die Eigenschaft status.
QTextDocument *QQuickTextDocument::textDocument() const
Gibt einen Zeiger auf das Objekt QTextDocument zurück.
Siehe auch setTextDocument().
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
Dieses Signal wird ausgegeben, wenn die zugrunde liegende QTextDocument durch eine andere Instanz ersetzt wird.
Diese Funktion wurde in Qt 6.7 eingeführt.
Siehe auch setTextDocument().
© 2025 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.
