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 |
속성
(technology preview)errorString : QString(technology preview)modified : bool(technology preview)source : QUrl(technology preview)status : Status
공개 함수
| QQuickTextDocument(QQuickItem *parent) | |
| QString | errorString() const |
| bool | isModified() const |
(technology preview) void | save() |
(technology preview) 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 |
신호
(technology preview) void | errorStringChanged() |
(technology preview) void | modifiedChanged() |
(technology preview) void | sourceChanged() |
(technology preview) void | statusChanged() |
(since 6.7) void | textDocumentChanged() |
상세 설명
이 클래스는 QQuickTextEdit 요소의 리치 텍스트 편집기( QTextDocument )에 대한 액세스를 제공합니다. 이는 문서 수정 등을 포함하여 Qt의 리치 텍스트 처리 기능을 사용할 수 있도록 하기 위해 제공됩니다. 또한 QTextDocumentWriter 와 같이 콘텐츠를 출력하거나, QSyntaxHighlighter 와 같이 추가 서식을 적용하는 데에도 사용할 수 있습니다.
속성 설명서
[read-only, technology preview] errorString : QString
이 열거형은 기술 미리 보기 단계에 있으며 변경될 수 있습니다.
이 속성은 로딩 또는 저장 중에 발생한 오류가 있는 경우, 해당 오류를 설명하는 사람이 읽을 수 있는 문자열을 포함합니다.
기본적으로 이 문자열은 비어 있습니다.
이 열거형은 Qt 6.7에서 도입되었습니다.
액세스 함수:
| QString | errorString() const |
Notifier 신호:
| void | errorStringChanged() |
status, source, save() 및 saveAs()도 참조하십시오 .
[technology preview] modified : bool
이 열거형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.
이 속성은 문서가 사용자에 의해 수정되었는지 여부를 나타냅니다.
이 속성은 문서가 마지막으로 로드되거나 저장된 이후 사용자가 문서를 수정했는지 여부를 나타냅니다. 기본적으로 이 속성의 값은 ` false`입니다.
QTextDocument::modified 와 마찬가지로 modified 속성을 설정할 수 있습니다. 예를 들어, 이 속성을 false 로 설정하면 source 속성을 다른 URL로 설정할 수 있습니다(따라서 사용자의 변경 사항이 무시됨).
이 열거형은 Qt 6.7에서 도입되었습니다.
액세스 함수:
| bool | isModified() const |
| void | setModified(bool modified) |
Notifier 신호:
| void | modifiedChanged() |
QTextDocument::modified도 참조하십시오 .
[technology preview] source : QUrl
이 열거형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.
이 속성은 Qt에서 지원하는 모든 텍스트 형식을 처리할 수 있는 문서 콘텐츠를 로드할 URL을 포함하며,
QQuickTextDocument Qt에서 지원하는 모든 텍스트 형식을 처리할 수 있으며, Qt에서 지원하는 모든 URL 스킴에서 로드될 수 있습니다.
문서의 ' modified ' 상태가 ' true'인 동안에는 ' source ' 속성을 변경할 수 없습니다. 사용자가 문서 내용을 수정한 경우, 사용자에게 ' save()'을 수행할지 여부를 묻거나, ' modified '을 ' false '으로 설정하여 변경 내용을 취소한 후 ' source ' 속성을 다른 URL로 설정해야 합니다.
이 열거형은 Qt 6.7에서 도입되었습니다.
액세스 함수:
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Notifier 신호:
| void | sourceChanged() |
참조: QTextDocumentWriter::supportedDocumentFormats().
[read-only, technology preview] status : Status
이 열거형은 기술 미리보기 단계에 있으며 변경될 수 있습니다.
이 속성은 문서 불러오기 또는 저장 상태를 나타냅니다.
이 속성은 문서 불러오기 또는 저장 상태를 나타냅니다. 다음 중 하나일 수 있습니다:
| 상수 | 설명 |
|---|---|
Null | 파일이 로드되지 않았습니다 |
Loading | source 에서 읽기가 시작되었습니다. |
Loaded | 읽기가 성공적으로 완료되었습니다 |
Saving | save() 또는 saveAs() 호출 후 파일 쓰기가 시작되었습니다. |
Saved | 쓰기가 성공적으로 완료되었습니다 |
ReadError | xml-ph-0000@deepl.internal에서 읽는 도중 오류가 발생했습니다 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, technology preview] void QQuickTextDocument::errorStringChanged()
이 기능은 기술 미리보기 단계에 있으며, 변경될 수 있습니다.
참고: 속성 ` errorString`에 대한알림 신호입니다.
[signal, technology preview] void QQuickTextDocument::modifiedChanged()
이 기능은 기술 미리보기 단계에 있으며, 향후 변경될 수 있습니다.
참고: 속성 ` modified`에 대한알림 신호입니다.
[invokable, technology preview] void QQuickTextDocument::save()
이 기능은 기술 미리보기 단계에 있으며, 변경될 수 있습니다.
source 에서 지정한 파일 및 형식으로 내용을 저장합니다.
참고: 로컬 파일에 저장하거나, Android에서는 content URL에 저장할 수있습니다 .
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
이 함수는 Qt 6.7에서 도입되었습니다.
[invokable, technology preview] void QQuickTextDocument::saveAs(const QUrl &url)
이 기능은 기술 미리보기 단계에 있으며, 변경될 수 있습니다.
url 에서 지정한 파일 및 형식으로 내용을 저장합니다.
url 에 지정된 파일 확장자는 파일 형식을 나타냅니다( QMimeDatabase::mimeTypeForUrl()에 따라 결정됨).
참고: 로컬 파일에 저장하거나, Android에서는 content URL에 저장할 수있습니다 .
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
이 함수는 Qt 6.7에서 도입되었습니다.
[since 6.7] void QQuickTextDocument::setTextDocument(QTextDocument *document)
지정된 ` document`를 설정합니다.
호출자는 문서의 소유권을 유지합니다.
이 함수는 Qt 6.7에서 도입되었습니다.
textDocument()도 참조하십시오 .
[signal, technology preview] void QQuickTextDocument::sourceChanged()
이 기능은 기술 미리보기 단계에 있으며, 변경될 수 있습니다.
참고: 속성 source 에 대한알림 신호입니다.
[signal, technology preview] void QQuickTextDocument::statusChanged()
이 기능은 기술 미리보기 단계에 있으며, 향후 변경될 수 있습니다.
참고: 속성 ` status`에 대한알림 신호.
QTextDocument *QQuickTextDocument::textDocument() const
QTextDocument 객체에 대한 포인터를 반환합니다.
setTextDocument()도 참조하십시오 .
[signal, since 6.7] void QQuickTextDocument::textDocumentChanged()
이 신호는 기본이 되는 ` QTextDocument `가 다른 인스턴스로 대체될 때 발생합니다.
이 함수는 Qt 6.7에서 도입되었습니다.
setTextDocument()도 참조하십시오 .
© 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.
