QQuickTextDocument Class
QQuickTextDocument 클래스는 QQuickTextEdit의 QTextDocument 에 대한 액세스를 제공합니다. 더 보기...
| 헤더: | #include <QQuickTextDocument> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| QML에서: | TextDocument |
| 상속합니다: | QObject |
속성
(preliminary)errorString : const QString(preliminary)modified : bool(preliminary)source : QUrl(preliminary)status : const Status
공공 기능
| QQuickTextDocument(QQuickItem *parent) | |
| QString | errorString() const |
| bool | isModified() const |
(preliminary) void | save() |
(preliminary) void | saveAs(const QUrl &url) |
| void | setModified(bool modified) |
| void | setSource(const QUrl &url) |
(since 6.7) void | setTextDocument(QTextDocument *document) |
| QUrl | source() const |
| QQuickTextDocument::Status | status() const |
| QTextDocument * | textDocument() const |
신호
(preliminary) void | errorStringChanged() |
(preliminary) void | modifiedChanged() |
(preliminary) void | sourceChanged() |
(preliminary) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
상세 설명
이 클래스는 QQuickTextEdit 요소의 QTextDocument 에 대한 액세스를 제공합니다. 이는 문서 수정을 포함한 Qt의 리치 텍스트 처리 기능을 사용할 수 있도록 하기 위해 제공됩니다. 또한 QTextDocumentWriter 와 같이 콘텐츠를 출력하거나 QSyntaxHighlighter 와 같이 추가 서식을 제공하는 데 사용할 수도 있습니다.
속성 문서
[read-only, preliminary] errorString : const QString
이 속성은 개발 중이며 변경될 수 있습니다.
이 속성에는 로드 또는 저장 중에 발생한 오류(있는 경우)를 설명하는 사람이 읽을 수 있는 문자열이 저장됩니다.
기본적으로 이 문자열은 비어 있습니다.
이 프로퍼티는 Qt 6.7에 도입되었습니다.
액세스 함수:
| QString | errorString() const |
알림 신호:
| void | errorStringChanged() |
status, source, save() 및 saveAs()도 참조하세요 .
[preliminary] modified : bool
이 속성은 개발 중이며 변경될 수 있습니다.
이 속성은 사용자가 문서를 수정했는지 여부를 보유합니다.
이 속성은 문서를 마지막으로 로드하거나 저장한 이후 사용자가 문서를 수정했는지 여부를 저장합니다. 기본적으로 이 속성은 false 입니다.
QTextDocument::modified 와 마찬가지로 수정된 속성을 설정할 수 있습니다. 예를 들어 false 로 설정하면 source 속성을 다른 URL로 설정할 수 있습니다(따라서 사용자가 변경한 내용이 삭제됨).
이 속성은 Qt 6.7에 도입되었습니다.
액세스 함수:
| bool | isModified() const |
| void | setModified(bool modified) |
알림 신호:
| void | modifiedChanged() |
QTextDocument::modified 를참조하십시오 .
[preliminary] source : QUrl
이 속성은 개발 중이며 변경될 수 있습니다.
이 속성은 문서 콘텐츠를 로드할 URL을 저장합니다.
QQuickTextDocument 는 Qt에서 지원하는 모든 텍스트 형식을 처리할 수 있으며, Qt에서 지원하는 모든 URL 체계에서 로드됩니다.
문서의 modified 상태가 true 인 동안에는 source 속성을 변경할 수 없습니다. 사용자가 문서 내용을 수정한 경우 사용자에게 save() 또는 modified 를 false 로 설정하여 변경 사항을 취소할지 여부를 묻는 메시지를 표시한 후 source 속성을 다른 URL로 설정해야 합니다.
이 속성은 Qt 6.7에 도입되었습니다.
액세스 함수:
| QUrl | source() const |
| void | setSource(const QUrl &url) |
알림 신호:
| void | sourceChanged() |
QTextDocumentWriter::supportedDocumentFormats()도 참조하십시오 .
[read-only, preliminary] status : const Status
이 속성은 개발 중이며 변경될 수 있습니다.
이 속성은 문서 로드 또는 저장 상태를 보유합니다.
이 속성은 문서 로드 또는 저장 상태를 보유합니다. 다음 중 하나일 수 있습니다:
| 상수 | 설명 |
|---|---|
Null | 파일이 로드되지 않았습니다. |
Loading | source 에서 읽기 시작 |
Loaded | 읽기가 성공적으로 완료되었습니다. |
Saving | save() 또는 saveAs() 다음에 파일 쓰기가 시작되었습니다. |
Saved | 쓰기가 성공적으로 완료되었습니다. |
ReadError | 다음에서 읽는 동안 오류가 발생했습니다. source |
WriteError | save() 또는 saveAs()에서 오류가 발생했습니다. |
NonLocalFileError | saveAs()가 로컬 파일이 아닌 원격 리소스를 가리키는 URL로 호출되었습니다. |
이 프로퍼티는 Qt 6.7에 도입되었습니다.
액세스 함수:
| QQuickTextDocument::Status | status() const |
알림 신호:
| void | statusChanged() |
errorString, source, save() 및 saveAs()도 참조하십시오 .
멤버 함수 문서
QQuickTextDocument::QQuickTextDocument(QQuickItem *parent)
parent 을 부모 객체로 하여 QQuickTextDocument 객체를 구축합니다.
[signal, preliminary] void QQuickTextDocument::errorStringChanged()
이 기능은 개발 중이며 변경될 수 있습니다.
참고: 속성에 대한 알림 신호 errorString.
[signal, preliminary] void QQuickTextDocument::modifiedChanged()
이 기능은 개발 중이며 변경될 수 있습니다.
참고: 속성에 대한 알림 신호 modified.
[invokable, preliminary] void QQuickTextDocument::save()
이 기능은 개발 중이며 변경될 수 있습니다.
source 에서 지정한 파일 및 형식과 동일한 파일에 콘텐츠를 저장합니다.
참고: file on a mounted filesystem 에만 저장할 수 있습니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
이 함수는 Qt 6.7에 도입되었습니다.
[invokable, preliminary] void QQuickTextDocument::saveAs(const QUrl &url)
이 기능은 개발 중이며 변경될 수 있습니다.
url 에서 지정한 파일 및 형식으로 콘텐츠를 저장합니다.
url 의 파일 확장자는 파일 형식을 지정합니다( QMimeDatabase::mimeTypeForUrl()에 의해 결정됨).
참고: file on a mounted filesystem 에만 저장할 수 있습니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
이 함수는 Qt 6.7에 도입되었습니다.
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
주어진 document 을 설정합니다.
호출자는 문서의 소유권을 유지합니다.
이 함수는 Qt 6.7에 도입되었습니다.
textDocument()도 참조하십시오 .
[signal, preliminary] void QQuickTextDocument::sourceChanged()
이 기능은 개발 중이며 변경될 수 있습니다.
참고: 속성에 대한 알림 신호 source.
[signal, preliminary] void QQuickTextDocument::statusChanged()
이 기능은 개발 중이며 변경될 수 있습니다.
참고: 속성에 대한 알림 신호 status.
QTextDocument *QQuickTextDocument::textDocument() const
QTextDocument 객체에 대한 포인터를 반환합니다.
setTextDocument()도 참조하세요 .
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
이 신호는 기본 QTextDocument 가 다른 인스턴스로 대체될 때 발생합니다.
이 함수는 Qt 6.7에 도입되었습니다.
setTextDocument()도 참조하십시오 .
© 2025 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.
