En esta página

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

  • void save() (technology preview)
  • void saveAs(url url) (technology preview)

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:

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

Véase también source y save().

© 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.