QTextBlockFormat Class
QTextBlockFormat 클래스는 QTextDocument 내의 텍스트 블록에 대한 서식 정보를 제공합니다. 더 보기...
| 헤더: | #include <QTextBlockFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속: | QTextFormat |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextBlockFormat은 리치 텍스트 처리 API 및 암시적 공유 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입 가능합니다.
공개 유형
| enum | LineHeightTypes { SingleHeight, ProportionalHeight, FixedHeight, MinimumHeight, LineDistanceHeight } |
| enum class | MarkerType { NoMarker, Unchecked, Checked } |
공개 함수
| QTextBlockFormat() | |
| Qt::Alignment | alignment() const |
| qreal | bottomMargin() const |
| int | headingLevel() const |
| int | indent() const |
| bool | isValid() const |
| qreal | leftMargin() const |
| qreal | lineHeight() const |
| qreal | lineHeight(qreal scriptLineHeight, qreal scaling = 1.0) const |
| int | lineHeightType() const |
| QTextBlockFormat::MarkerType | marker() const |
| bool | nonBreakableLines() const |
| QTextFormat::PageBreakFlags | pageBreakPolicy() const |
| qreal | rightMargin() const |
| void | setAlignment(Qt::Alignment alignment) |
| void | setBottomMargin(qreal margin) |
| void | setHeadingLevel(int level) |
| void | setIndent(int indentation) |
| void | setLeftMargin(qreal margin) |
| void | setLineHeight(qreal height, int heightType) |
| void | setMarker(QTextBlockFormat::MarkerType marker) |
| void | setNonBreakableLines(bool b) |
| void | setPageBreakPolicy(QTextFormat::PageBreakFlags policy) |
| void | setRightMargin(qreal margin) |
| void | setTabPositions(const QList<QTextOption::Tab> &tabs) |
| void | setTextIndent(qreal indent) |
| void | setTopMargin(qreal margin) |
| QList<QTextOption::Tab> | tabPositions() const |
| qreal | textIndent() const |
| qreal | topMargin() const |
상세 설명
문서는 QTextBlock 객체로 표현되는 블록 목록으로 구성됩니다. 각 블록은 텍스트 단락, 표, 목록 또는 이미지와 같은 특정 항목을 포함할 수 있습니다. 모든 블록에는 해당 특성을 지정하는 QTextBlockFormat이 연관되어 있습니다.
왼쪽에서 오른쪽(LTR) 및 오른쪽에서 왼쪽(RTL) 언어를 지원하기 위해 setLayoutDirection()을 사용하여 블록의 방향을 설정할 수 있습니다. 단락 정렬은 setAlignment()을 사용하여 설정합니다. 여백은 setTopMargin(), setBottomMargin(), setLeftMargin(), setRightMargin()을 통해 제어됩니다. 전체 들여쓰기는 setIndent()을 사용하여 설정하고, 첫 줄 들여쓰기는 setTextIndent()을 사용하여 설정합니다.
줄 간격은 setLineHeight()을 통해 설정되며, lineHeight() 및 lineHeightType()을 통해 조회할 수 있습니다. 사용 가능한 줄 간격 유형은 LineHeightTypes 열거형에 정의되어 있습니다.
줄 바꿈은 setNonBreakableLines()을 사용하여 활성화하거나 비활성화할 수 있습니다.
단락의 배경을 채우는 데 사용되는 브러시는 setBackground()로 설정되며, 텍스트의 다른 모양은 setProperty() 함수를 사용하여 OutlinePen, ForegroundBrush 및 BackgroundBrush QTextFormat::Property 값으로 사용자 정의할 수 있습니다.
텍스트 블록이 목록의 일부인 경우, listFormat() 함수를 통해 접근할 수 있는 목록 서식을 가질 수도 있습니다.
QTextBlock 및 QTextCharFormat도 참조하십시오 .
멤버 유형 문서
enum QTextBlockFormat::LineHeightTypes
이 열거형은 단락에서 지원할 수 있는 다양한 줄 간격 유형을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTextBlockFormat::SingleHeight | 0 | 이것은 기본 줄 높이인 단일 간격입니다. |
QTextBlockFormat::ProportionalHeight | 1 | 이 상수는 줄 간격을 줄 길이에 비례하여(백분율로) 설정합니다. 예를 들어, 줄 간격을 두 배로 하려면 200으로 설정합니다. |
QTextBlockFormat::FixedHeight | 2 | 이 설정은 줄 간격을 고정된 값(픽셀 단위)으로 설정합니다. |
QTextBlockFormat::MinimumHeight | 3 | 이 설정은 최소 줄 간격(픽셀 단위)을 지정합니다. |
QTextBlockFormat::LineDistanceHeight | 4 | 이 설정은 줄 사이에 지정된 높이(픽셀 단위)를 추가합니다. |
lineHeight(), lineHeightType(), setLineHeight()도 참조하십시오 .
enum class QTextBlockFormat::MarkerType
이 열거형은 목록 항목이 가질 수 있는 마커의 유형을 설명합니다. 목록 항목( QTextBlock::textList() 함수가 목록을 반환하는 단락)에 마커가 있는 경우, 일반 글머리 기호 대신 해당 마커가 표시됩니다. 이러한 방식으로, 동일한 목록 내에서 체크 가능한 목록 항목과 일반 목록 항목을 혼합하여 사용할 수 있으며, 이 경우 목록 전체에 대해 ` QTextListFormat::style()`가 지정한 글머리 기호 유형이 재정의됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTextBlockFormat::MarkerType::NoMarker | 0 | 이것이 기본값이며, 목록 항목의 글머리 기호가 표시됩니다. |
QTextBlockFormat::MarkerType::Unchecked | 1 | 상수값설명이것이 기본값입니다. 목록 항목의 글머리 기호가 표시됩니다. 목록 항목의 글머리 기호 대신, 선택되지 않은 확인란이 표시됩니다. |
QTextBlockFormat::MarkerType::Checked | 2 | 목록 항목의 글머리 기호 대신, 선택된 체크박스가 표시됩니다. |
향후에는 다른 유형의 단락 장식도 지정할 수 있도록 확장될 수 있습니다.
QTextListFormat::style()도 참조하십시오 .
멤버 함수 문서
QTextBlockFormat::QTextBlockFormat()
새로운 QTextBlockFormat 객체를 생성합니다.
Qt::Alignment QTextBlockFormat::alignment() const
단락의 정렬 방식을 반환합니다.
setAlignment()도 참조하십시오 .
qreal QTextBlockFormat::bottomMargin() const
단락의 하단 여백을 반환합니다.
setBottomMargin() 및 topMargin()도 참조하십시오 .
int QTextBlockFormat::headingLevel() const
해당 단락이 제목인 경우 제목 수준을 반환하고, 그렇지 않은 경우 0을 반환합니다.
setHeadingLevel()도 참조하십시오 .
int QTextBlockFormat::indent() const
단락의 들여쓰기 값을 반환합니다.
setIndent()도 참조하십시오 .
bool QTextBlockFormat::isValid() const
이 블록 형식이 유효하면 ` true `를 반환하고, 그렇지 않으면 `false`를 반환합니다.
qreal QTextBlockFormat::leftMargin() const
단락의 왼쪽 여백을 반환합니다.
setLeftMargin(), rightMargin(), indent()도 참조하십시오 .
qreal QTextBlockFormat::lineHeight() const
이 메서드는 단락의 LineHeight 속성을 반환합니다.
LineHeightTypes, setLineHeight() 및 lineHeightType()도 참조하십시오 .
qreal QTextBlockFormat::lineHeight(qreal scriptLineHeight, qreal scaling = 1.0) const
scriptLineHeight 로 지정된 스크립트 줄의 높이와 지정된 줄 높이 계수( scaling )를 기준으로 단락 내 줄의 높이를 반환합니다.
반환되는 값은 단락에 지정된 LineHeightType과 단락에 설정된 LineHeight 설정에도 따라 달라집니다.
고정된 픽셀 수를 포함하는 높이의 경우, 인쇄에 적합하도록 적절하게 크기를 조정하기 위해 스케일링이 필요합니다.
LineHeightTypes, setLineHeight() 및 lineHeightType()도 참조하십시오 .
int QTextBlockFormat::lineHeightType() const
이 메서드는 단락의 LineHeightType 속성을 반환합니다.
LineHeightTypes, setLineHeight() 및 lineHeight()도 참조하십시오 .
QTextBlockFormat::MarkerType QTextBlockFormat::marker() const
단락 마커가 설정되어 있으면 해당 마커를 반환하고, 설정되어 있지 않으면 ` NoMarker `를 반환합니다.
setMarker()도 참조하십시오 .
bool QTextBlockFormat::nonBreakableLines() const
단락 내의 줄이 줄바꿈이 불가능한 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
setNonBreakableLines()도 참조하십시오 .
QTextFormat::PageBreakFlags QTextBlockFormat::pageBreakPolicy() const
해당 단락에 현재 설정된 페이지 나누기 정책을 반환합니다. 기본값은 ‘ QTextFormat::PageBreak_Auto ’입니다.
setPageBreakPolicy()도 참조하십시오 .
qreal QTextBlockFormat::rightMargin() const
단락의 오른쪽 여백을 반환합니다.
setRightMargin() 및 leftMargin()도 참조하십시오 .
void QTextBlockFormat::setAlignment(Qt::Alignment alignment)
단락의 alignment 을 설정합니다.
alignment()도 참조하십시오 .
void QTextBlockFormat::setBottomMargin(qreal margin)
단락의 하단 margin 을 설정합니다.
bottomMargin(), setTopMargin(), setLeftMargin() 및 setRightMargin()도 참조하십시오 .
void QTextBlockFormat::setHeadingLevel(int level)
단락의 제목 수준 level 을 설정합니다. 여기서 1은 최상위 제목 유형(일반적으로 가능한 최대 제목 글꼴 크기를 가짐)이며, 값이 커질수록 문서 내에서 점점 하위 수준으로 내려갑니다(일반적으로 글꼴 크기가 더 작아짐). 예를 들어 HTML H1 태그를 읽을 때, 제목 수준은 1로 설정됩니다. 제목 수준을 설정한다고 해서 글꼴 크기가 자동으로 변경되지는 않지만 QTextDocumentFragment::fromHtml()는 제목 수준과 글꼴 크기를 동시에 설정합니다.
단락이 제목이 아닌 경우, 레벨은 0(기본값)으로 설정되어야 합니다.
headingLevel()도 참조하십시오 .
void QTextBlockFormat::setIndent(int indentation)
단락의 여백( indentation)을 설정합니다. 여백은 들여쓰기와는 별도로 setLeftMargin() 및 setTextIndent()을 사용하여 설정됩니다. 여백( indentation )은 문서 전체의 표준 들여쓰기 값에 곱해지는 정수이며, 이를 곱한 값이 단락의 실제 들여쓰기 값이 됩니다.
indent() 및 QTextDocument::indentWidth()도 참조하십시오 .
void QTextBlockFormat::setLeftMargin(qreal margin)
단락의 왼쪽 들여쓰기 margin 를 설정합니다. 들여쓰기는 setIndent()를 사용하여 별도로 적용할 수 있습니다.
leftMargin(), setRightMargin(), setTopMargin() 및 setBottomMargin()도 참조하십시오 .
void QTextBlockFormat::setLineHeight(qreal height, int heightType)
단락의 줄 간격을 height 에서 지정한 값으로 설정합니다. 이 값은 LineHeightTypes 열거형에 설명된 방식에 따라 heightType 에 따라 달라집니다.
LineHeightTypes, lineHeight(), lineHeightType()도 참조하십시오 .
void QTextBlockFormat::setMarker(QTextBlockFormat::MarkerType marker)
단락과 함께 렌더링될 장식 유형을 ` marker`로 설정합니다. 예를 들어, 목록 항목의 글머리 기호 대신 체크된 상태이거나 체크되지 않은 상태의 체크박스로 장식할 수 있습니다. 기본값은 ` NoMarker`입니다.
marker()도 참조하십시오 .
void QTextBlockFormat::setNonBreakableLines(bool b)
b 가 true인 경우, 해당 단락의 줄은 줄바꿈 불가로 처리되며, 그렇지 않은 경우 줄바꿈 가능으로 처리됩니다.
nonBreakableLines()도 참조하십시오 .
void QTextBlockFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
해당 단락의 페이지 나누기 정책을 ‘ policy ’로 설정합니다.
pageBreakPolicy()도 참조하십시오 .
void QTextBlockFormat::setRightMargin(qreal margin)
단락의 오른쪽 margin 를 설정합니다.
rightMargin(), setLeftMargin(), setTopMargin(), setBottomMargin()도 참조하십시오 .
void QTextBlockFormat::setTabPositions(const QList<QTextOption::Tab> &tabs)
텍스트 블록의 탭 위치를 tabs 에서 지정한 대로 설정합니다.
tabPositions()도 참조하십시오 .
void QTextBlockFormat::setTextIndent(qreal indent)
블록의 첫 번째 줄에 대한 indent 를 설정합니다. 이를 통해 단락의 첫 번째 줄을 다른 줄과 다르게 들여쓰기하여 텍스트의 가독성을 높일 수 있습니다.
textIndent(), setLeftMargin(), setRightMargin(), setTopMargin() 및 setBottomMargin()도 참조하십시오 .
void QTextBlockFormat::setTopMargin(qreal margin)
단락의 상단 margin 을 설정합니다.
topMargin(), setBottomMargin(), setLeftMargin(), setRightMargin()도 참조하십시오 .
QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const
텍스트 블록에 정의된 탭 위치 목록을 반환합니다.
setTabPositions()도 참조하십시오 .
qreal QTextBlockFormat::textIndent() const
단락의 텍스트 들여쓰기 값을 반환합니다.
setTextIndent()도 참조하십시오 .
qreal QTextBlockFormat::topMargin() const
단락의 상단 여백을 반환합니다.
setTopMargin() 및 bottomMargin()도 참조하십시오 .
© 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.