TextDocument QML Type (Uncreatable)
Una capa de abstracción sobre el servicio de fondo de TextEdit: QTextDocument. Más información...
| Import Statement: | import QtQuick |
| In C++: | QQuickTextDocument |
| Status: | Technology preview |
Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- errorString : string
(technology preview) - modified : bool
(technology preview) - source : url
(technology preview) - status : enumeration
(technology preview)
Métodos
Descripción detallada
Para cargar texto en el documento, configura la propiedad ` source `. Si, a continuación, el usuario modifica el texto y desea guardar el mismo documento, llama a ` save()` para guardarlo de nuevo en la misma fuente (solo si ` it's a local file`). O bien, llama a ` saveAs()` para guardarlo en un archivo diferente.
Esta clase no se puede instanciar en QML, pero está disponible en TextEdit::textDocument.
Nota: Por el momento,todas las operaciones de carga y guardado se realizan de forma sincrónica. Esto puede bloquear la interfaz de usuario si source es una unidad de red lenta. Es posible que esto se mejore en futuras versiones de Qt.
Nota: Esta API se considera una vista previa técnica y puede sufrir cambios en futuras versiones de Qt.
Documentación de propiedades
errorString : string [read-only, technology preview]
Esta propiedad 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 ha producido durante la carga o el guardado, si lo hay; en caso contrario, una cadena vacía.
Esta propiedad se introdujo en Qt 6.7.
Véase también status, source, save() y saveAs().
modified : bool [technology preview]
Esta propiedad se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Esta propiedad indica si el usuario ha modificado el documento desde la última vez que se cargó o guardó. De forma predeterminada, esta propiedad es « false ».
Al igual que con QTextDocument::modified, puedes establecer la propiedad modified: por ejemplo, configúrala como false para permitir establecer la propiedad source en una URL diferente (descartando así los cambios del usuario).
Esta propiedad se introdujo en Qt 6.7.
Véase también QTextDocument::modified.
source : url [technology preview]
Esta propiedad se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
QQuickTextDocument Puede gestionar cualquier formato de texto compatible con Qt, cargado desde cualquier esquema de URL compatible con Qt.
La URL puede ser absoluta o relativa a la URL del componente.
La propiedad « source » no se puede modificar mientras el estado de « 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 = false » antes de establecer la propiedad «source» en una URL diferente.
Esta propiedad se introdujo en Qt 6.7.
Véase también QTextDocumentWriter::supportedDocumentFormats().
status : enumeration [read-only, technology preview]
Esta propiedad se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Esta propiedad indica el estado de carga o guardado del documento. Puede adoptar uno de los siguientes valores:
| Constante | Descripción |
|---|---|
TextDocument.Null | No se ha cargado ningún archivo |
TextDocument.Loading | Se ha iniciado la lectura desde source |
TextDocument.Loaded | La lectura ha finalizado correctamente |
TextDocument.Saving | Se ha iniciado la escritura del archivo tras llamar a save() o saveAs() |
TextDocument.Saved | La escritura ha finalizado correctamente |
TextDocument.ReadError | Se ha producido un error al leer desde source |
TextDocument.WriteError | Se ha producido un error en save() o saveAs() |
TextDocument.NonLocalFileError | saveAs() se ha llamado con una URL que apunta a un recurso remoto en lugar de a un archivo local |
Utiliza este estado para proporcionar una actualización o responder al cambio de estado de alguna manera. Por ejemplo, podrías:
- Provocar un cambio de estado:
State { name: 'loaded' when: textEdit.textDocument.status == textEdit.textDocument.Loaded } - Implementar un controlador de señales para
onStatusChanged:TextEdit { onStatusChanged: { if (textDocument.status === textDocument.Loaded) console.log('Loaded') } } - Vincular al valor del estado:
TextEdit { id: edit width: 300 height: 200 textFormat: TextEdit.MarkdownText textDocument.source: "example.md" wrapMode: TextEdit.WordWrap Text { anchors { bottom: parent.bottom right: parent.right } color: edit.textDocument.status === TextDocument.Loaded ? "darkolivegreen" : "tomato" text: switch (edit.textDocument.status) { case TextDocument.Loading: return qsTr("Loading ") + edit.textDocument.source case TextDocument.Loaded: return qsTr("Loaded ") + edit.textDocument.source default: return edit.textDocument.errorString } } }
Esta propiedad se introdujo en Qt 6.7.
Véase también errorString, source, save() y saveAs().
Documentación del método
[technology preview] void save()
Este método se encuentra en fase de vista previa tecnológica y está sujeto a cambios.
Guarda el contenido en el mismo archivo y con el mismo formato especificados en source.
Nota: Puedes guardar el contenido en un archivo local o, en Android, en una URL de content.
Este método se introdujo en Qt 6.7.
Véase también source y saveAs().
[technology preview] void saveAs(url url)
Este método se encuentra en fase de vista previa tecnológica y está sujeto 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.
Este método se introdujo en Qt 6.7.
© 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.