TextDocument QML Type

Una envoltura alrededor de TextEdit's respaldo QTextDocument. Más...

Este tipo está en desarrollo y está sujeto a cambios.

• Lista de todos los miembros, incluidos los heredados

Propiedades

• errorString : string (preliminary)
• modified : bool (preliminary)
• source : url (preliminary)
• status : enumeration (preliminary)

Métodos

• void save() (preliminary)
• void saveAs(url url) (preliminary)

Descripción detallada

Para cargar texto en el documento, establezca la propiedad source. Si a continuación el usuario modifica el texto y desea guardar el mismo documento, llame a save() para guardarlo de nuevo en la misma fuente (sólo si it's a local file). O llame a saveAs() para guardarlo en un archivo diferente.

Esta clase no puede instanciarse en QML, pero está disponible en TextEdit::textDocument.

Documentación de Propiedades

errorString : string [read-only, preliminary]

Esta propiedad está en desarrollo y está sujeta a cambios.

Esta propiedad contiene una cadena legible por humanos que describe el error que se produjo durante la carga o el guardado, si lo hubo; 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 [preliminary]

Esta propiedad está en desarrollo y está sujeta a cambios.

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.

Véase también QTextDocument::modified.

source : url [preliminary]

Esta propiedad está en desarrollo y está sujeta a cambios.

QQuickTextDocument puede manejar cualquier formato de texto soportado por Qt, cargado desde cualquier esquema de URL soportado por Qt.

La URL puede ser absoluta o relativa a la URL del componente.

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 = false antes de establecer la propiedad source a una URL diferente.

Esta propiedad se introdujo en Qt 6.7.

Véase también QTextDocumentWriter::supportedDocumentFormats().

status : enumeration [read-only, preliminary]

Esta propiedad está en desarrollo y está sujeta a cambios.

Esta propiedad contiene el estado de carga o guardado del documento. Puede ser uno de los siguientes

Utilice este estado para proporcionar una actualización o responder al cambio de estado de alguna manera. Por ejemplo, podría

• Activar un cambio de estado:

  State {
      name: 'loaded'
      when: textEdit.textDocument.status == textEdit.textDocument.Loaded
  }

• Implementar un gestor de señales onStatusChanged:

  TextEdit {
      onStatusChanged: {
          if (textDocument.status === textDocument.Loaded)
              console.log('Loaded')
      }
  }

• Vincular al valor de 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

[preliminary] void save()

Este método está en desarrollo y está sujeto a cambios.

Guarda el contenido en el mismo archivo y formato especificados por source.

Este método se introdujo en Qt 6.7.

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

[preliminary] void saveAs(url url)

Este método está en desarrollo y está sujeto 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()).

Este método se introdujo en Qt 6.7.

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