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**
은 굵은 문자 스타일로 "굵게"라는 텍스트가 포함된 문서 조각이 됩니다.
참고: 외부 리소스 로드는 지원되지 않습니다.
이 기능은 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 조각을 할당합니다.
© 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.