QTextFragment Class
QTextFragment 클래스는 단일 QTextCharFormat 를 가진 QTextDocument 에 텍스트 조각을 저장합니다. 더 보기...
| 헤더: | #include <QTextFragment> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextFragment는 리치 텍스트 처리 API의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 함수
| QTextFragment() | |
| QTextFragment(const QTextFragment &other) | |
| QTextCharFormat | charFormat() const |
| int | charFormatIndex() const |
| bool | contains(int position) const |
| QList<QGlyphRun> | glyphRuns(int pos = -1, int len = -1) const |
| bool | isValid() const |
| int | length() const |
| int | position() const |
| QString | text() const |
| bool | operator!=(const QTextFragment &other) const |
| bool | operator<(const QTextFragment &other) const |
| QTextFragment & | operator=(const QTextFragment &other) |
| bool | operator==(const QTextFragment &other) const |
상세 설명
텍스트 조각은 단일 문자 형식으로 저장된 텍스트 부분을 나타냅니다. 문자 형식이 변경되는 텍스트는 형식이 다른 텍스트 조각의 시퀀스로 표현될 수 있습니다.
사용자가 조각 내의 텍스트를 편집하여 다른 문자 서식을 적용하면, 서식이 변경되는 지점마다 조각의 텍스트가 분할되고 새로운 조각이 생성됩니다. 예를 들어, 문장 중간에 있는 일부 텍스트의 스타일을 변경하면 해당 단편은 세 개의 별도 단편으로 나뉩니다. 첫 번째와 세 번째 단편은 이전과 동일한 형식을 유지하고, 두 번째 단편은 새로운 스타일을 갖게 됩니다. 첫 번째 단편에는 문장의 시작 부분부터의 텍스트가, 두 번째 단편에는 중간 부분부터의 텍스트가, 세 번째 단편에는 문장의 끝 부분부터의 텍스트가 포함됩니다.

단편의 텍스트 및 문자 서식은 ` text()` 및 ` charFormat()` 함수를 사용하여 얻을 수 있습니다. ` length()` 함수는 단편 내 텍스트의 길이를 반환합니다. ` position()`는 문서 내에서 단편의 시작 위치를 반환합니다. 단편에 문서 내의 특정 위치가 포함되어 있는지 확인하려면 ` contains()` 함수를 사용하십시오.
‘ QTextDocument ’ 및 ‘Rich Text Document Structure’항목도 참조하십시오 .
멤버 함수 설명서
QTextFragment::QTextFragment()
새로운 빈 텍스트 조각을 생성합니다.
QTextFragment::QTextFragment(const QTextFragment &other)
other 텍스트 단편의 내용(텍스트 및 서식)을 이 텍스트 단편으로 복사합니다.
QTextCharFormat QTextFragment::charFormat() const
텍스트 조각의 문자 형식을 반환합니다.
text()도 참조하십시오 .
int QTextFragment::charFormatIndex() const
텍스트 조각의 문자 형식에 해당하는, 문서의 내부 문자 형식 목록 내 인덱스를 반환합니다.
QTextDocument::allFormats()도 참조하십시오 .
bool QTextFragment::contains(int position) const
텍스트 조각에 문서 내 지정된 position 위치의 텍스트가 포함되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
QList<QGlyphRun> QTextFragment::glyphRuns(int pos = -1, int len = -1) const
pos 위치부터 시작하는 이 텍스트 조각의 len 문자에 해당하는 글리프를 반환합니다. 글리프의 위치는 QTextBlock 의 레이아웃 위치를 기준으로 합니다.
pos 가 0보다 작으면, QTextFragment 의 시작 위치가 기본값으로 사용됩니다. len 가 0보다 작으면, 조각의 길이가 기본값으로 사용됩니다.
QGlyphRun, QTextBlock::layout(), QTextLayout::position(), QPainter::drawGlyphRun()도 참조하십시오 .
bool QTextFragment::isValid() const
이것이 유효한 텍스트 단편(즉, 문서 내에서 유효한 위치를 갖는)인 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.
int QTextFragment::length() const
텍스트 조각의 문자 수를 반환합니다.
text()도 참조하십시오 .
int QTextFragment::position() const
문서 내에서 이 텍스트 조각의 위치를 반환합니다.
QString QTextFragment::text() const
텍스트 조각을 일반 텍스트로 반환합니다.
length() 및 charFormat()도 참조하십시오 .
bool QTextFragment::operator!=(const QTextFragment &other) const
이 텍스트 조각이 other 의 텍스트 조각과 (위치가 다른) 다른 경우 ` true `를 반환하고, 그렇지 않은 경우 `false`를 반환합니다.
bool QTextFragment::operator<(const QTextFragment &other) const
이 텍스트 조각이 ‘ other ’ 텍스트 조각보다 문서 내에서 더 앞쪽에 나타나면 ‘ true ’을 반환하고, 그렇지 않으면 ‘ false ’을 반환합니다.
QTextFragment &QTextFragment::operator=(const QTextFragment &other)
other 텍스트 조각의 내용(텍스트 및 서식)을 이 텍스트 조각에 할당합니다.
bool QTextFragment::operator==(const QTextFragment &other) const
이 텍스트 조각이 other 에 있는 텍스트 조각과 (동일한 위치에서) 일치하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
© 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.