En esta página

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

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:

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:

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:

ConstanteDescripción
NullNo se ha cargado ningún archivo
LoadingSe ha iniciado la lectura desde source
LoadedLa lectura ha finalizado correctamente
SavingSe ha iniciado la escritura del archivo tras save() o saveAs()
SavedLa escritura ha finalizado correctamente
ReadErrorSe ha producido un error al leer desde source
WriteErrorSe ha producido un error en save() o saveAs()
NonLocalFileErrorsaveAs() 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.