QTextOption Class

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

Header: #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, AddSpaceForLineAndParagraphSeparators, SuppressColors }
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참조하세요 .

멤버 유형 문서

열거형 QTextOption::Flag
플래그 QTextOption::플래그

Constant설명
QTextOption::IncludeTrailingSpaces0x80000000이 옵션이 설정되면 QTextLine::naturalTextWidth() 및 naturalTextRect()는 텍스트의 후행 공백 너비를 포함하는 값을 반환하고, 그렇지 않으면 이 너비는 제외됩니다.
QTextOption::ShowTabsAndSpaces0x1공백은 작은 점으로, 탭은 작은 화살표로 시각화합니다. 끊어지지 않는 공백은 끊어지는 공백과 다르게 표시됩니다.
QTextOption::ShowLineAndParagraphSeparators0x2적절한 기호 문자로 줄과 단락 구분을 시각화합니다.
QTextOption::ShowDocumentTerminator (since Qt 5.7)0x10섹션 기호로 문서의 끝을 시각화합니다.
QTextOption::AddSpaceForLineAndParagraphSeparators0x4줄 바꿈 위치를 결정할 때 구분 문자를 그리기 위해 추가된 공백을 고려합니다.
QTextOption::SuppressColors0x8문자 형식의 모든 색상 변경을 억제합니다(기본 선택 항목 제외).

플래그 유형은 QFlags<Flag>에 대한 타입 정의입니다. 플래그 값의 OR 조합을 저장합니다.

enum QTextOption::TabType

이 열거형에는 다양한 유형의 표 계산기가 있습니다.

Constant설명
QTextOption::LeftTab0왼쪽 탭
QTextOption::RightTab1오른쪽 탭
QTextOption::CenterTab2가운데 탭
QTextOption::DelimiterTab3특정 구분 기호 문자에서 멈추는 탭입니다.

enum QTextOption::WrapMode

이 열거형은 문서에서 텍스트가 래핑되는 방식을 설명합니다.

Constant설명
QTextOption::NoWrap0텍스트가 전혀 줄 바꿈되지 않습니다.
QTextOption::WordWrap1텍스트는 단어 경계에서 줄 바꿈됩니다.
QTextOption::ManualWrap2QTextOption::NoWrap과 동일합니다.
QTextOption::WrapAnywhere3텍스트가 단어 중간에 있더라도 줄의 어느 지점에서든 줄 바꿈할 수 있습니다.
QTextOption::WrapAtWordBoundaryOrAnywhere4가능하면 단어 경계에서 줄 바꿈이 발생하고, 그렇지 않으면 단어 중간에 있더라도 줄의 적절한 지점에서 줄 바꿈이 발생합니다.

멤버 함수 문서

QTextOption::QTextOption()

텍스트에 대한 기본 속성을 사용하여 텍스트 옵션을 구성합니다. 텍스트 맞춤 속성은 Qt::AlignLeft 로 설정됩니다. 단어 줄 바꿈 속성은 QTextOption::WordWrap 으로 설정됩니다. 디자인 메트릭 플래그 사용은 false로 설정됩니다.

QTextOption::QTextOption(Qt::Alignment alignment)

텍스트에 지정된 alignment 으로 텍스트 옵션을 구성합니다. 단어 줄 바꿈 속성은 QTextOption::WordWrap 로 설정됩니다. 디자인 메트릭 플래그 사용은 false로 설정됩니다.

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 이 참이면 레이아웃은 디자인 메트릭을 사용하고, 그렇지 않으면 페인트 장치의 메트릭을 사용합니다(기본 동작).

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)

텍스트 옵션이 other 텍스트 옵션과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

© 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.