QTextOption Class
QTextOption 클래스는 일반적인 리치 텍스트 속성에 대한 설명을 제공합니다. 더 보기...
| 헤더: | #include <QTextOption> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextOption은 리치 텍스트 처리 API의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 타입
| struct | Tab |
| enum | Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, ShowDefaultIgnorables, …, DisableEmojiParsing } |
| flags | Flags |
| enum | TabType { LeftTab, RightTab, CenterTab, DelimiterTab } |
| enum | WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere } |
공개 함수
| QTextOption() | |
| QTextOption(Qt::Alignment alignment) | |
| QTextOption(const QTextOption &other) | |
| ~QTextOption() | |
| Qt::Alignment | alignment() const |
| QTextOption::Flags | flags() const |
| void | setAlignment(Qt::Alignment alignment) |
| void | setFlags(QTextOption::Flags flags) |
| void | setTabArray(const QList<qreal> &tabStops) |
| void | setTabStopDistance(qreal tabStopDistance) |
| void | setTabs(const QList<QTextOption::Tab> &tabStops) |
| void | setTextDirection(Qt::LayoutDirection direction) |
| void | setUseDesignMetrics(bool enable) |
| void | setWrapMode(QTextOption::WrapMode mode) |
| QList<qreal> | tabArray() const |
| qreal | tabStopDistance() const |
| QList<QTextOption::Tab> | tabs() const |
| Qt::LayoutDirection | textDirection() const |
| bool | useDesignMetrics() const |
| QTextOption::WrapMode | wrapMode() const |
| QTextOption & | operator=(const QTextOption &other) |
상세 설명
QTextOption은 일반적인 리치 텍스트 속성을 단일 객체에 캡슐화하는 데 사용됩니다. 여기에는 텍스트 정렬, 레이아웃 방향, 단어 줄 바꿈 및 텍스트 렌더링 및 레이아웃과 관련된 기타 표준 속성에 대한 정보가 포함되어 있습니다.
QTextEdit, QTextDocument 및 QTextCursor도 참조하십시오 .
멤버 유형 설명
enum QTextOption::Flag
flags QTextOption::Flags
| 상수 | 값 | 설명 |
|---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | 이 옵션이 설정된 경우, ` QTextLine::naturalTextWidth()` 및 `naturalTextRect()`는 텍스트의 끝부분 공백 너비를 포함한 값을 반환하며, 그렇지 않은 경우 이 너비는 제외됩니다. |
QTextOption::ShowTabsAndSpaces | 0x1 | 공백은 작은 점으로, 탭은 작은 화살표로 표시합니다. 비분리 공백은 분리 공백과 다르게 표시됩니다. |
QTextOption::ShowLineAndParagraphSeparators | 0x2 | 줄 및 단락 구분자를 적절한 기호 문자로 표시합니다. |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | 문서 끝을 섹션 기호로 표시합니다. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9) | 0x20 | 글꼴에서 지원하는 경우, 일반적으로 표시되지 않는 문자를 렌더링합니다. |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | 줄 바꿈 위치를 결정할 때 구분 기호를 그리는 데 추가되는 공백을 고려하십시오. |
QTextOption::SuppressColors | 0x8 | 문자 서식에서 발생하는 모든 색상 변경을 억제하십시오(주 선택 항목 제외). |
QTextOption::DisableEmojiParsing (since Qt 6.9) | 0x40 | 기본적으로 Qt는 입력 문자열에서 이모지 시퀀스를 감지하고, 이를 표시할 때 컬러 폰트 사용을 우선시합니다. 이 추가 단계가 필요하지 않다는 것을 미리 알고 있는 경우, DisableEmojiParsing 플래그를 설정하여 비활성화할 수 있습니다. |
Flags 유형은 QFlags<Flag>에 대한 typedef입니다. 이 유형은 Flag 값들의 OR 조합을 저장합니다.
enum QTextOption::TabType
이 열거형은 다양한 종류의 탭 기호를 포함합니다
| 상수 | 값 | 설명 |
|---|---|---|
QTextOption::LeftTab | 0 | 왼쪽 탭 |
QTextOption::RightTab | 1 | 오른쪽 탭 |
QTextOption::CenterTab | 2 | 중앙 정렬 탭 |
QTextOption::DelimiterTab | 3 | 특정 구분자 문자에 멈추는 탭 |
enum QTextOption::WrapMode
이 열거형은 문서 내에서 텍스트가 어떻게 줄바꿈되는지를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTextOption::NoWrap | 0 | 텍스트가 전혀 줄 바꿈되지 않습니다. |
QTextOption::WordWrap | 1 | 텍스트가 단어 경계에서 줄바꿈됩니다. |
QTextOption::ManualWrap | 2 | QTextOption::NoWrap과 동일 |
QTextOption::WrapAnywhere | 3 | 단어 중간에 위치하더라도 줄의 어느 지점에서나 텍스트가 줄바꿈될 수 있습니다. |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | 가능한 경우 단어 경계에서 줄 바꿈이 발생하며, 그렇지 않은 경우 단어 중간이라도 줄의 적절한 지점에서 줄 바꿈이 발생합니다. |
멤버 함수 설명서
QTextOption::QTextOption()
텍스트에 대한 기본 속성을 가진 텍스트 옵션을 생성합니다. 텍스트 정렬 속성은 ‘ Qt::AlignLeft ’로 설정됩니다. 단어 줄바꿈 속성은 ‘ QTextOption::WordWrap ’로 설정됩니다. 디자인 메트릭 사용 플래그는 false로 설정됩니다.
참고: 이 생성자를호출하면 기본 텍스트 방향이 Qt::LayoutDirectionAuto 로 설정됩니다.
QTextOption::QTextOption(Qt::Alignment alignment)
지정된 텍스트 방향( alignment )을 사용하여 텍스트 옵션을 생성합니다. 줄 바꿈(word wrap) 속성은 ‘ QTextOption::WordWrap ’로 설정됩니다. 디자인 메트릭스(design metrics) 사용 플래그는 false로 설정됩니다.
참고: 이 생성자를호출하면 기본 텍스트 방향이 시스템 로케일에 따라 달라지는 QGuiApplication::layoutDirection()의 현재 값으로 설정됩니다. 하위 호환성을 위해, 이 설정은 기본 생성자가 설정하는 기본 텍스트 방향과 일치하지 않습니다.
QTextOption::QTextOption(const QTextOption &other)
other 텍스트 옵션의 복사본을 생성합니다.
[noexcept] QTextOption::~QTextOption()
텍스트 옵션을 제거합니다.
Qt::Alignment QTextOption::alignment() const
해당 옵션으로 정의된 텍스트 정렬 방식을 반환합니다.
setAlignment()도 참조하십시오 .
QTextOption::Flags QTextOption::flags() const
해당 옵션과 관련된 플래그를 반환합니다.
setFlags()도 참조하십시오 .
void QTextOption::setAlignment(Qt::Alignment alignment)
옵션의 텍스트 정렬을 지정된 alignment 로 설정합니다.
alignment()도 참조하십시오 .
void QTextOption::setFlags(QTextOption::Flags flags)
해당 옵션과 관련된 플래그를 지정된 ` flags`로 설정합니다.
flags()도 참조하십시오 .
void QTextOption::setTabArray(const QList<qreal> &tabStops)
텍스트 레이아웃의 탭 위치를 tabStops 에서 지정한 대로 설정합니다.
tabArray(), setTabStopDistance() 및 setTabs()도 참조하십시오 .
void QTextOption::setTabStopDistance(qreal tabStopDistance)
탭 정지점 간의 기본 간격을 장치 단위로 tabStopDistance 에서 지정한 값으로 설정합니다.
tabStopDistance(), setTabArray(), setTabs() 및 tabs()도 참조하십시오 .
void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)
텍스트 레이아웃의 탭 위치를 tabStops 에 지정된 값으로 설정합니다.
tabs() 및 tabStopDistance()도 참조하십시오 .
void QTextOption::setTextDirection(Qt::LayoutDirection direction)
해당 옵션으로 정의된 텍스트 레이아웃의 방향을 지정된 direction 로 설정합니다.
textDirection()도 참조하십시오 .
void QTextOption::setUseDesignMetrics(bool enable)
enable 가 true인 경우 레이아웃은 디자인 메트릭을 사용하며, 그렇지 않은 경우 페인트 장치의 메트릭을 사용합니다(이것이 기본 동작입니다).
useDesignMetrics()도 참조하십시오 .
void QTextOption::setWrapMode(QTextOption::WrapMode mode)
옵션의 텍스트 줄바꿈 모드를 지정된 mode 로 설정합니다.
wrapMode()도 참조하십시오 .
QList<qreal> QTextOption::tabArray() const
텍스트 레이아웃에 대해 정의된 탭 위치 목록을 반환합니다.
setTabArray() 및 tabStopDistance()도 참조하십시오 .
qreal QTextOption::tabStopDistance() const
탭 정지점 간의 거리를 장치 단위로 반환합니다.
setTabStopDistance(), tabArray(), setTabs(), tabs()도 참조하십시오 .
QList<QTextOption::Tab> QTextOption::tabs() const
텍스트 레이아웃에 대해 정의된 탭 위치 목록을 반환합니다.
tabStopDistance(), setTabs(), setTabStopDistance()도 참조하십시오 .
Qt::LayoutDirection QTextOption::textDirection() const
해당 옵션으로 정의된 텍스트 레이아웃의 방향을 반환합니다.
참고: 하위 호환성 문제로인해 텍스트 방향의 기본값은 사용하는 생성자에 따라 다릅니다. 자세한 내용은 각 생성자의 문서를 참조하십시오.
setTextDirection()도 참조하십시오 .
bool QTextOption::useDesignMetrics() const
레이아웃이 기기 메트릭 대신 디자인 메트릭을 사용하는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.
setUseDesignMetrics()도 참조하십시오 .
QTextOption::WrapMode QTextOption::wrapMode() const
해당 옵션으로 정의된 텍스트 줄바꿈 모드를 반환합니다.
setWrapMode()도 참조하십시오 .
QTextOption &QTextOption::operator=(const QTextOption &other)
text 옵션이 other text 옵션과 동일하면 ` 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.