QQuickTextDocument Class
La clase QQuickTextDocument proporciona acceso a la página QTextDocument de QQuickTextEdit. Más...
| Cabecera: | #include <QQuickTextDocument> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| En QML: | TextDocument |
| Hereda: | QObject |
Propiedades
(preliminary)errorString : QString(preliminary)modified : bool(preliminary)source : QUrl(preliminary)status : Status
Funciones públicas
| 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 |
Señales
(preliminary) void | errorStringChanged() |
(preliminary) void | modifiedChanged() |
(preliminary) void | sourceChanged() |
(preliminary) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
Descripción Detallada
Esta clase proporciona acceso a la QTextDocument de elementos QQuickTextEdit. Esto se proporciona para permitir el uso de las funcionalidades de Procesamiento de Texto Enriquecido de Qt, incluyendo modificaciones de documentos. También puede utilizarse para dar salida al contenido, por ejemplo con QTextDocumentWriter, o proporcionar formato adicional, por ejemplo con QSyntaxHighlighter.
Documentación de propiedades
[read-only, preliminary] errorString : QString
Esta propiedad está en desarrollo y está sujeta a cambios.
Esta propiedad contiene una cadena legible por humanos que describe el error que se ha producido durante la carga o el almacenamiento, si se ha producido.
Por defecto esta cadena está vacía.
Esta propiedad se introdujo en Qt 6.7.
Funciones de acceso:
| QString | errorString() const |
Notifier signal:
| void | errorStringChanged() |
Véase también status, source, save(), y saveAs().
[preliminary] modified : bool
Esta propiedad está en desarrollo y está sujeta a cambios.
Esta propiedad indica si el documento ha sido modificado por el usuario
Esta propiedad indica si el documento ha sido modificado por el usuario desde la última vez que fue cargado o guardado. Por defecto, esta propiedad es false.
Al igual que con QTextDocument::modified, puedes establecer la propiedad modified: por ejemplo, establécela a false para permitir establecer la propiedad source a una URL diferente (descartando así los cambios del usuario).
Esta propiedad se introdujo en Qt 6.7.
Funciones de acceso:
| bool | isModified() const |
| void | setModified(bool modified) |
Señal de notificador:
| void | modifiedChanged() |
Véase también QTextDocument::modified.
[preliminary] source : QUrl
Esta propiedad está en desarrollo y está sujeta a cambios.
Esta propiedad contiene la URL desde la que cargar el contenido del documento
QQuickTextDocument puede manejar cualquier formato de texto soportado por Qt, cargado desde cualquier esquema de URL soportado por Qt.
La propiedad source no puede cambiarse mientras el estado del documento modified sea true. Si el usuario ha modificado el contenido del documento, debe preguntarle si desea save(), o bien descartar los cambios estableciendo modified a false antes de establecer la propiedad source a una URL diferente.
Esta propiedad se introdujo en Qt 6.7.
Funciones de acceso:
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Señal de notificador:
| void | sourceChanged() |
Véase también QTextDocumentWriter::supportedDocumentFormats().
[read-only, preliminary] status : Status
Esta propiedad está en desarrollo y está sujeta a cambios.
Esta propiedad contiene el estado de carga o guardado del documento
Esta propiedad contiene el estado de carga o guardado del documento. Puede ser uno de los siguientes:
| Constante | Descripción |
|---|---|
Null | No se ha cargado ningún fichero |
Loading | Se ha iniciado la lectura desde source |
Loaded | La lectura ha finalizado correctamente |
Saving | Se ha iniciado la escritura del archivo después de save() o saveAs() |
Saved | La escritura ha finalizado correctamente |
ReadError | Se ha producido un error al leer de source |
WriteError | Se ha producido un error en save() o saveAs() |
NonLocalFileError | saveAs() se ha llamado con una URL que apuntaba a un recurso remoto en lugar de a un archivo local |
Esta propiedad se introdujo en Qt 6.7.
Funciones de acceso:
| QQuickTextDocument::Status | status() const |
Señal de notificador:
| void | statusChanged() |
Véase también errorString, source, save(), y saveAs().
Documentación de las funciones miembro
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
Construye un objeto QQuickTextDocument con parent como objeto padre.
[signal, preliminary] void QQuickTextDocument::errorStringChanged()
Esta función está en desarrollo y está sujeta a cambios.
Nota: Señal de notificación para la propiedad errorString.
[signal, preliminary] void QQuickTextDocument::modifiedChanged()
Esta función está en desarrollo y está sujeta a cambios.
Nota: Señal de notificación para la propiedad modified.
[invokable, preliminary] void QQuickTextDocument::save()
Esta función está en desarrollo y está sujeta a cambios.
Guarda el contenido en el mismo archivo y formato especificados por source.
Nota: Sólo se puede guardar en un file on a mounted filesystem.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Esta función se introdujo en Qt 6.7.
Véase también source y saveAs().
[invokable, preliminary] void QQuickTextDocument::saveAs(const QUrl &url)
Esta función está en desarrollo y está sujeta a cambios.
Guarda el contenido en el archivo y formato especificados por url.
La extensión del archivo en url especifica el formato del archivo (determinado por QMimeDatabase::mimeTypeForUrl()).
Nota: Sólo se puede guardar en un file on a mounted filesystem.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Esta función se introdujo en Qt 6.7.
Véase también source y save().
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
Establece la dirección document.
El autor de la llamada conserva la propiedad del documento.
Esta función se introdujo en Qt 6.7.
Véase también textDocument().
[signal, preliminary] void QQuickTextDocument::sourceChanged()
Esta función está en desarrollo y está sujeta a cambios.
Nota: Señal de notificación para la propiedad source.
[signal, preliminary] void QQuickTextDocument::statusChanged()
Esta función está en desarrollo y está sujeta a cambios.
Nota: Señal de notificación para la propiedad status.
QTextDocument *QQuickTextDocument::textDocument() const
Devuelve un puntero al objeto QTextDocument.
Véase también setTextDocument().
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
Esta señal se emite cuando el QTextDocument subyacente se sustituye por una instancia diferente.
Esta función se introdujo en Qt 6.7.
Véase también 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.
