QTextDocumentFragment Class
QTextDocumentFragment 클래스는 ` QTextDocument`에서 가져온 서식이 지정된 텍스트 조각을 나타냅니다. 더 보기...
| 헤더: | #include <QTextDocumentFragment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextDocumentFragment는 리치 텍스트 처리 API 및 암시적 공유 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 함수
| QTextDocumentFragment() | |
| QTextDocumentFragment(const QTextCursor &cursor) | |
| QTextDocumentFragment(const QTextDocument *document) | |
| QTextDocumentFragment(const QTextDocumentFragment &other) | |
| ~QTextDocumentFragment() | |
| bool | isEmpty() const |
| QString | toHtml() const |
(since 6.4) QString | toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const |
| QString | toPlainText() const |
(since 6.4) QString | toRawText() const |
| QTextDocumentFragment & | operator=(const QTextDocumentFragment &other) |
정적 공용 멤버
| QTextDocumentFragment | fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr) |
(since 6.4) QTextDocumentFragment | fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) |
| QTextDocumentFragment | fromPlainText(const QString &plainText) |
상세 설명
QTextDocumentFragment는 리치 텍스트의 일부로, QTextDocument 에 삽입될 수 있습니다. 문서 조각은 QTextDocument, QTextCursor 의 선택 영역 또는 다른 문서 조각에서 생성될 수 있습니다. 문서 조각은 정적 함수인 fromPlainText() 및 fromHtml()을 통해서도 생성될 수 있습니다.
문서 단편의 내용은 toRawText() 함수를 사용하여 원본 텍스트로, toPlainText()을 사용하여 ASCII로, toHtml()을 사용하여 HTML로, 또는 toMarkdown()을 사용하여 마크다운 형식으로 가져올 수 있습니다.
멤버 함수 문서
QTextDocumentFragment::QTextDocumentFragment()
빈 QTextDocumentFragment를 생성합니다.
isEmpty()도 참조하십시오 .
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextCursor &cursor)
cursor 의 선택 영역을 기반으로 QTextDocumentFragment를 생성합니다. 커서에 선택 영역이 없는 경우, 생성된 프래그먼트는 비어 있습니다.
isEmpty() 및 QTextCursor::selection()도 참조하십시오 .
[explicit] QTextDocumentFragment::QTextDocumentFragment(const QTextDocument *document)
지정된 ` document `를 `QTextDocumentFragment`로 변환합니다. `QTextDocumentFragment`는 문서 내용만 저장할 뿐, 문서 제목과 같은 메타 정보는 저장하지 않는다는 점에 유의하십시오.
QTextDocumentFragment::QTextDocumentFragment(const QTextDocumentFragment &other)
복사 생성자. ‘ other ’ 조각의 복사본을 생성합니다.
[noexcept] QTextDocumentFragment::~QTextDocumentFragment()
문서 조각을 삭제합니다.
[static] QTextDocumentFragment QTextDocumentFragment::fromHtml(const QString &text, const QTextDocument *resourceProvider = nullptr)
주어진 text 내의 임의의 HTML 조각을 기반으로 QTextDocumentFragment 객체를 반환합니다. 서식은 가능한 한 그대로 유지됩니다. 예를 들어, "<b>bold</b>"는 "bold"라는 텍스트가 굵은 글씨 서식으로 표시된 문서 조각이 됩니다.
제공된 HTML에 임포트된 스타일시트와 같은 외부 리소스에 대한 참조가 포함되어 있는 경우, 해당 리소스는 resourceProvider 를 통해 로드됩니다.
[static, since 6.4] QTextDocumentFragment QTextDocumentFragment::fromMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)
지정된 markdown 텍스트와 features 을 기반으로 QTextDocumentFragment 를 반환합니다. 기본값은 GitHub 방언입니다.
서식은 가능한 한 그대로 유지됩니다. 예를 들어, **bold** 는 "bold"라는 텍스트가 굵은 글꼴 스타일로 표시된 문서 조각이 됩니다.
참고: 외부 리소스로딩은 지원되지 않습니다.
이 함수는 Qt 6.4에서 도입되었습니다.
[static] QTextDocumentFragment QTextDocumentFragment::fromPlainText(const QString &plainText)
지정된 plainText 를 포함하는 문서 조각을 반환합니다.
이러한 조각을 QTextDocument 에 삽입할 때, 삽입에 사용되는 QTextCursor 의 현재 문자 형식이 텍스트의 형식으로 사용됩니다.
bool QTextDocumentFragment::isEmpty() const
프래그먼트가 비어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
QString QTextDocumentFragment::toHtml() const
문서 조각의 내용을 HTML 형식으로 반환합니다.
toPlainText(), toMarkdown() 및 QTextDocument::toHtml()도 참조하십시오 .
[since 6.4] QString QTextDocumentFragment::toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const
지정된 마크다운 방언( features)을 사용하여 문서 조각의 내용을 마크다운 형식으로 반환합니다. 기본값은 GitHub 방언입니다.
이 함수는 Qt 6.4에서 도입되었습니다.
toPlainText() 및 QTextDocument::toMarkdown()도 참조하십시오 .
QString QTextDocumentFragment::toPlainText() const
이 함수는 ` toRawText()`와 동일한 결과를 반환하지만, 일부 유니코드 문자를 ASCII 대체 문자로 바꿉니다. 특히, 비분리 공백(U+00A0)은 일반 공백(U+0020)으로, 단락 구분자(U+2029)와 줄 구분자(U+2028)는 모두 줄 바꿈(U+000A)으로 대체됩니다. 문서의 정확한 내용을 필요로 하는 경우, 대신 toRawText()를 사용하십시오.
toHtml(), toMarkdown() 및 toRawText()도 참조하십시오 .
[since 6.4] QString QTextDocumentFragment::toRawText() const
문서 조각의 텍스트를 원시 텍스트(즉, 서식 정보가 없는 상태)로 반환합니다.
이 함수는 Qt 6.4에서 도입되었습니다.
toHtml(), toMarkdown() 및 toPlainText()도 참조하십시오 .
QTextDocumentFragment &QTextDocumentFragment::operator=(const QTextDocumentFragment &other)
other 조각을 이 조각에 할당합니다.
© 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.