이 페이지에서

QTextOption Class

QTextOption 클래스는 일반적인 리치 텍스트 속성에 대한 설명을 제공합니다. 더 보기...

헤더: #include <QTextOption>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

참고: 이 클래스의 모든 함수는 재진입 가능합니다.

공개 타입

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::IncludeTrailingSpaces0x80000000이 옵션이 설정된 경우, ` QTextLine::naturalTextWidth()` 및 `naturalTextRect()`는 텍스트의 끝부분 공백 너비를 포함한 값을 반환하며, 그렇지 않은 경우 이 너비는 제외됩니다.
QTextOption::ShowTabsAndSpaces0x1공백은 작은 점으로, 탭은 작은 화살표로 표시합니다. 비분리 공백은 분리 공백과 다르게 표시됩니다.
QTextOption::ShowLineAndParagraphSeparators0x2줄 및 단락 구분자를 적절한 기호 문자로 표시합니다.
QTextOption::ShowDocumentTerminator (since Qt 5.7)0x10문서 끝을 섹션 기호로 표시합니다.
QTextOption::ShowDefaultIgnorables (since Qt 6.9)0x20글꼴에서 지원하는 경우, 일반적으로 표시되지 않는 문자를 렌더링합니다.
QTextOption::AddSpaceForLineAndParagraphSeparators0x4줄 바꿈 위치를 결정할 때 구분 기호를 그리는 데 추가되는 공백을 고려하십시오.
QTextOption::SuppressColors0x8문자 서식에서 발생하는 모든 색상 변경을 억제하십시오(주 선택 항목 제외).
QTextOption::DisableEmojiParsing (since Qt 6.9)0x40기본적으로 Qt는 입력 문자열에서 이모지 시퀀스를 감지하고, 이를 표시할 때 컬러 폰트 사용을 우선시합니다. 이 추가 단계가 필요하지 않다는 것을 미리 알고 있는 경우, DisableEmojiParsing 플래그를 설정하여 비활성화할 수 있습니다.

Flags 유형은 QFlags<Flag>에 대한 typedef입니다. 이 유형은 Flag 값들의 OR 조합을 저장합니다.

enum QTextOption::TabType

이 열거형은 다양한 종류의 탭 기호를 포함합니다

상수값설명
QTextOption::LeftTab0왼쪽 탭
QTextOption::RightTab1오른쪽 탭
QTextOption::CenterTab2중앙 정렬 탭
QTextOption::DelimiterTab3특정 구분자 문자에 멈추는 탭

enum QTextOption::WrapMode

이 열거형은 문서 내에서 텍스트가 어떻게 줄바꿈되는지를 설명합니다.

상수값설명
QTextOption::NoWrap0텍스트가 전혀 줄 바꿈되지 않습니다.
QTextOption::WordWrap1텍스트가 단어 경계에서 줄바꿈됩니다.
QTextOption::ManualWrap2QTextOption::NoWrap과 동일
QTextOption::WrapAnywhere3단어 중간에 위치하더라도 줄의 어느 지점에서나 텍스트가 줄바꿈될 수 있습니다.
QTextOption::WrapAtWordBoundaryOrAnywhere4가능한 경우 단어 경계에서 줄 바꿈이 발생하며, 그렇지 않은 경우 단어 중간이라도 줄의 적절한 지점에서 줄 바꿈이 발생합니다.

멤버 함수 설명서

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.