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이거나 컴포넌트의 URL을 기준으로 한 상대 URL일 수 있습니다.

문서의 ‘ modified ’ 상태가 ‘ true ’인 동안에는 ‘ source ’ 속성을 변경할 수 없습니다. 사용자가 문서 내용을 수정한 경우, ‘ save()’을 실행할지 여부를 사용자에게 묻거나, ‘ modified = false ’을 설정하여 변경 사항을 취소한 후 ‘source’ 속성을 다른 URL로 설정해야 합니다.

이 속성은 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()도 참조하십시오 .