QQuickTextDocument Class
La clase `QQuickTextDocument` permite acceder al ` QTextDocument ` de `QQuickTextEdit`. Más información...
| Encabezado: | #include <QQuickTextDocument> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| En QML: | TextDocument |
| Heredan de: | QObject |
Propiedades
(technology preview)errorString : QString(technology preview)modified : bool(technology preview)source : QUrl(technology preview)status : Status
Funciones públicas
| 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 |
Señales
(technology preview) void | errorStringChanged() |
(technology preview) void | modifiedChanged() |
(technology preview) void | sourceChanged() |
(technology preview) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
Descripción detallada
Esta clase proporciona acceso a la propiedad ` QTextDocument ` de los elementos `QQuickTextEdit`. Se proporciona para permitir el uso de las funcionalidades de procesamiento de texto enriquecido de Qt, incluidas las modificaciones de documentos. También se puede utilizar para generar contenido, por ejemplo con ` QTextDocumentWriter`, o para aplicar formato adicional, por ejemplo con ` QSyntaxHighlighter`.
Documentación de propiedades
[read-only, technology preview] errorString : QString
Esta enumeración se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Esta propiedad contiene una cadena legible para el usuario que describe el error que se produjo durante la carga o el guardado, si lo hubiera
Por defecto, esta cadena está vacía.
Esta enumeración se introdujo en Qt 6.7.
Funciones de acceso:
| QString | errorString() const |
Señal de notificador:
| void | errorStringChanged() |
Véase también status, source, save() y saveAs().
[technology preview] modified : bool
Esta enumeración se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Esta propiedad indica si el usuario ha modificado el documento
Esta propiedad indica si el usuario ha modificado el documento desde la última vez que se cargó o se guardó. De forma predeterminada, esta propiedad es « false ».
Al igual que con « QTextDocument::modified », puedes establecer la propiedad «modified»: por ejemplo, configúrala en « false » para permitir establecer la propiedad « source » en una URL diferente (descartando así los cambios del usuario).
Esta enumeración se introdujo en Qt 6.7.
Funciones de acceso:
| bool | isModified() const |
| void | setModified(bool modified) |
Señal Notifier:
| void | modifiedChanged() |
Véase también QTextDocument::modified.
[technology preview] source : QUrl
Esta enumeración se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Esta propiedad contiene la URL desde la que se carga el contenido del documento
QQuickTextDocument puede gestionar cualquier formato de texto compatible con Qt, cargado desde cualquier esquema de URL compatible con Qt.
La propiedad ` source ` no se puede modificar mientras el estado ` modified ` del documento sea ` true`. Si el usuario ha modificado el contenido del documento, debes preguntarle si desea ` save()` o, de lo contrario, descartar los cambios estableciendo ` modified ` en ` false ` antes de establecer la propiedad ` source ` en una URL diferente.
Esta enumeración se introdujo en Qt 6.7.
Funciones de acceso:
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Señal Notifier:
| void | sourceChanged() |
Véase también QTextDocumentWriter::supportedDocumentFormats().
[read-only, technology preview] status : Status
Esta enumeración se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Esta propiedad contiene el estado de carga o guardado del documento
Esta propiedad indica el estado de carga o guardado del documento. Puede adoptar uno de los siguientes valores:
| Constante | Descripción |
|---|---|
Null | No se ha cargado ningún archivo |
Loading | Se ha iniciado la lectura desde source |
Loaded | La lectura ha finalizado correctamente |
Saving | Se ha iniciado la escritura del archivo tras save() o saveAs() |
Saved | La escritura ha finalizado correctamente |
ReadError | Se ha producido un error al leer desde source |
WriteError | Se ha producido un error en save() o saveAs() |
NonLocalFileError | saveAs() se ha llamado con una URL que apunta a un recurso remoto en lugar de a un archivo local |
Esta enumeración 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)
Crea un objeto `QQuickTextDocument` con ` parent ` como objeto padre.
[signal, technology preview] void QQuickTextDocument::errorStringChanged()
Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Nota: Señalde notificador para la propiedad « errorString ».
[signal, technology preview] void QQuickTextDocument::modifiedChanged()
Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Nota: Señalde notificador para la propiedad modified.
[invokable, technology preview] void QQuickTextDocument::save()
Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Guarda el contenido en el mismo archivo y con el mismo formato especificados por source.
Nota: Puedes guardar el contenido en un archivo local o, en Android, en una URL de content.
Nota: Esta función se puede invocar 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, technology preview] void QQuickTextDocument::saveAs(const QUrl &url)
Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Guarda el contenido en el archivo y con el formato especificados en url.
La extensión del archivo en url especifica el formato del archivo (según lo determinado por QMimeDatabase::mimeTypeForUrl()).
Nota: Puedes guardar en un archivo local o, en Android, en una URL de content.
Nota: Esta función se puede invocar 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 el document indicado.
El llamante conserva la propiedad del documento.
Esta función se introdujo en Qt 6.7.
Véase también textDocument().
[signal, technology preview] void QQuickTextDocument::sourceChanged()
Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Nota: Señalde notificador para la propiedad « source ».
[signal, technology preview] void QQuickTextDocument::statusChanged()
Esta función se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Nota: Señalde 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 la instancia de « QTextDocument » subyacente se sustituye por otra instancia.
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.