TextDocument QML Type (Uncreatable)

这是对TextEdit 中底层服务QTextDocument 的封装。更多内容...

此类型处于技术预览阶段，可能会有变动。

注意：此类型不可创建，无法在 QML 中实例化。

• 所有成员列表（包括继承的成员）

属性

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

方法

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

详细说明

要将文本加载到文档中，请设置source 属性。如果用户随后修改了文本并希望保存同一文档，请调用save()将其再次保存到同一源文件中（仅当it's a local file 时）。或者调用saveAs()将其保存到另一个文件中。

该类无法在 QML 中实例化，但可通过TextEdit::textDocument 访问。

属性文档

errorString : string [read-only, technology preview]

此属性处于技术预览阶段，可能会有变动。

该属性保存一个易于理解的字符串，用于描述加载或保存过程中发生的错误（如有）；否则，该属性为空字符串。

该属性自 Qt 6.7 起引入。

另请参阅 status 、source 、save() 以及saveAs()。

modified : bool [technology preview]

此属性处于技术预览阶段，可能会有变动。

该属性用于标识文档自上次加载或保存以来是否已被用户修改。默认情况下，该属性的值为false 。

与QTextDocument::modified 类似，您可以设置modified属性：例如，将其设置为false ，以便将source 属性设置为另一个URL（从而舍弃用户的更改）。

该属性在 Qt 6.7 中引入。

另请参阅 QTextDocument::modified 。

source : url [technology preview]

此属性处于技术预览阶段，可能会有变动。

QQuickTextDocument 可处理 Qt 支持的任何文本格式，这些格式可从 Qt 支持的任何 URL 方案中加载。

URL 可以是绝对路径，也可以是相对于组件 URL 的相对路径。

当文档的“modified ”状态为“true ”时，无法更改source 属性。如果用户修改了文档内容，您应提示用户是否要“save()”，否则请在将source属性设置为其他URL之前，通过设置modified = false 来丢弃更改。

该属性在 Qt 6.7 中引入。

另请参阅 QTextDocumentWriter::supportedDocumentFormats()。

status : enumeration [read-only, technology preview]

此属性处于技术预览阶段，可能会发生变更。

该属性用于表示文档的加载或保存状态。其取值可能为以下之一：

请使用此状态来提供更新或以某种方式响应状态变化。例如，您可以：

• 触发状态变更：

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

• 实现onStatusChanged 信号处理程序：

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

• 绑定到状态值：

  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
              }
      }
  }

该属性在 Qt 6.7 中引入。

另请参阅 errorString 、source 、save() 以及saveAs()。

方法文档

[technology preview] void save()

此方法处于技术预览阶段，可能会有变动。

将内容保存到由 `source` 指定的同一文件和格式中。

此方法在 Qt 6.7 中引入。

另请参阅 source 和saveAs()。

[technology preview] void saveAs(url url)

此方法处于技术预览阶段，可能会有变动。

将内容保存到由 `url` 指定的文件和格式中。

url 中的文件扩展名指定了文件格式（由QMimeDatabase::mimeTypeForUrl() 确定）。

此方法在 Qt 6.7 中引入。

另请参阅 source 和save()。