QTextFrameFormat Class
QTextFrameFormat 클래스는 QTextDocument 내의 프레임에 대한 서식 정보를 제공합니다. 더 보기...
| 헤더: | #include <QTextFrameFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속: | QTextFormat |
| 상속받는 클래스: |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QTextFrameFormat은 리치 텍스트 처리 API 및 암시적 공유 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재입력 가능합니다.
공개 유형
| enum | BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset } |
| enum | Position { InFlow, FloatLeft, FloatRight } |
공개 함수
| QTextFrameFormat() | |
| qreal | border() const |
| QBrush | borderBrush() const |
| QTextFrameFormat::BorderStyle | borderStyle() const |
| qreal | bottomMargin() const |
| QTextLength | height() const |
| bool | isValid() const |
| qreal | leftMargin() const |
| qreal | margin() const |
| qreal | padding() const |
| QTextFormat::PageBreakFlags | pageBreakPolicy() const |
| QTextFrameFormat::Position | position() const |
| qreal | rightMargin() const |
| void | setBorder(qreal width) |
| void | setBorderBrush(const QBrush &brush) |
| void | setBorderStyle(QTextFrameFormat::BorderStyle style) |
| void | setBottomMargin(qreal margin) |
| void | setHeight(const QTextLength &height) |
| void | setHeight(qreal height) |
| void | setLeftMargin(qreal margin) |
| void | setMargin(qreal margin) |
| void | setPadding(qreal width) |
| void | setPageBreakPolicy(QTextFormat::PageBreakFlags policy) |
| void | setPosition(QTextFrameFormat::Position policy) |
| void | setRightMargin(qreal margin) |
| void | setTopMargin(qreal margin) |
| void | setWidth(const QTextLength &width) |
| void | setWidth(qreal width) |
| qreal | topMargin() const |
| QTextLength | width() const |
상세 설명
텍스트 프레임은 하나 이상의 텍스트 블록을 그룹화하여 단락보다 더 큰 구조 계층을 제공합니다. 프레임의 형식은 화면에서 프레임이 렌더링되고 배치되는 방식을 지정합니다. 프레임은 내부 텍스트 서식의 동작을 직접 지정하지는 않지만, 자식 요소의 레이아웃에 대한 제약 조건을 제공합니다.
프레임 형식은 화면상의 프레임의 width() 및 height()을 정의합니다. 각 프레임은 내용을 직사각형 상자로 둘러싸는 테두리( border())를 가질 수 있습니다. 테두리는 프레임을 둘러싼 테두리 상자( margin())로 둘러싸여 있으며, 프레임의 내용과 테두리는 프레임의 내부 경계( padding())에 의해 분리되어 있습니다. 이러한 구조는 HTML 페이지에 사용되는 캐스케이딩 스타일 시트(CSS)의 박스 모델과 유사합니다.

프레임의 position()은 setPosition()을 사용하여 설정되며, 주변 텍스트에 대해 프레임이 어떻게 배치될지를 결정합니다.
QTextFrameFormat 객체의 유효성은 isValid() 함수를 사용하여 확인할 수 있습니다.
QTextFrame 및 QTextBlockFormat도 참조하십시오 .
멤버 유형 설명서
enum QTextFrameFormat::BorderStyle
이 열거형은 텍스트 프레임의 다양한 테두리 스타일을 설명합니다.
| 상수 | 값 |
|---|---|
QTextFrameFormat::BorderStyle_None | 0 |
QTextFrameFormat::BorderStyle_Dotted | 1 |
QTextFrameFormat::BorderStyle_Dashed | 2 |
QTextFrameFormat::BorderStyle_Solid | 3 |
QTextFrameFormat::BorderStyle_Double | 4 |
QTextFrameFormat::BorderStyle_DotDash | 5 |
QTextFrameFormat::BorderStyle_DotDotDash | 6 |
QTextFrameFormat::BorderStyle_Groove | 7 |
QTextFrameFormat::BorderStyle_Ridge | 8 |
QTextFrameFormat::BorderStyle_Inset | 9 |
QTextFrameFormat::BorderStyle_Outset | 10 |
borderStyle() 및 FrameBorderStyle도 참조하십시오 .
enum QTextFrameFormat::Position
이 열거형은 프레임이 주변 텍스트에 대해 어떤 위치에 있는지를 나타냅니다.
| 상수 | 값 |
|---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
멤버 함수 문서
QTextFrameFormat::QTextFrameFormat()
기본 속성을 가진 텍스트 프레임 형식 객체를 생성합니다.
qreal QTextFrameFormat::border() const
테두리의 너비를 픽셀 단위로 반환합니다.
setBorder()도 참조하십시오 .
QBrush QTextFrameFormat::borderBrush() const
프레임의 테두리에 사용된 브러시를 반환합니다.
setBorderBrush()도 참조하십시오 .
QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const
프레임 테두리의 스타일을 반환합니다.
setBorderStyle()도 참조하십시오 .
qreal QTextFrameFormat::bottomMargin() const
프레임의 하단 여백 너비를 픽셀 단위로 반환합니다.
setBottomMargin()도 참조하십시오 .
QTextLength QTextFrameFormat::height() const
프레임의 테두리 사각형의 높이를 반환합니다.
setHeight()도 참조하십시오 .
bool QTextFrameFormat::isValid() const
형식 설명이 유효하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
qreal QTextFrameFormat::leftMargin() const
프레임의 왼쪽 여백 너비를 픽셀 단위로 반환합니다.
setLeftMargin()도 참조하십시오 .
qreal QTextFrameFormat::margin() const
프레임의 외부 여백 너비를 픽셀 단위로 반환합니다.
setMargin()도 참조하십시오 .
qreal QTextFrameFormat::padding() const
프레임의 내부 패딩 너비를 픽셀 단위로 반환합니다.
setPadding()도 참조하십시오 .
QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const
프레임/테이블에 대해 현재 설정된 페이지 나누기 정책을 반환합니다. 기본값은 ‘ QTextFormat::PageBreak_Auto ’입니다.
setPageBreakPolicy()도 참조하십시오 .
QTextFrameFormat::Position QTextFrameFormat::position() const
이 프레임 형식을 가진 프레임에 대한 배치 정책을 반환합니다.
setPosition()도 참조하십시오 .
qreal QTextFrameFormat::rightMargin() const
프레임의 오른쪽 여백 너비를 픽셀 단위로 반환합니다.
setRightMargin()도 참조하십시오 .
void QTextFrameFormat::setBorder(qreal width)
프레임 테두리의 width (픽셀 단위)를 설정합니다.
border()도 참조하십시오 .
void QTextFrameFormat::setBorderBrush(const QBrush &brush)
프레임 테두리에 사용되는 brush 를 설정합니다.
borderBrush()도 참조하십시오 .
void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)
프레임 테두리의 style 를 설정합니다.
borderStyle()도 참조하십시오 .
void QTextFrameFormat::setBottomMargin(qreal margin)
프레임의 하단 margin 을 픽셀 단위로 설정합니다.
bottomMargin()도 참조하십시오 .
void QTextFrameFormat::setHeight(const QTextLength &height)
프레임의 height 를 설정합니다.
height()도 참조하십시오 .
void QTextFrameFormat::setHeight(qreal height)
프레임의 ` height`를 설정합니다.
이 함수는 오버로드된 함수입니다.
void QTextFrameFormat::setLeftMargin(qreal margin)
프레임의 왼쪽 margin 을 픽셀 단위로 설정합니다.
leftMargin()도 참조하십시오 .
void QTextFrameFormat::setMargin(qreal margin)
프레임의 ‘ margin ’을 픽셀 단위로 설정합니다. 이 메서드는 또한 프레임의 왼쪽, 오른쪽, 위쪽, 아래쪽 여백을 동일한 값으로 설정합니다. 개별 여백은 전체 여백보다 우선 적용됩니다.
margin()도 참조하십시오 .
void QTextFrameFormat::setPadding(qreal width)
프레임의 내부 패딩 width 을 픽셀 단위로 설정합니다.
padding()도 참조하십시오 .
void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
프레임/표의 페이지 나누기 정책을 ‘ policy ’로 설정합니다.
pageBreakPolicy()도 참조하십시오 .
void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)
이 프레임 형식을 사용하여 프레임의 위치를 지정하기 위한 ‘ policy ’을 설정합니다.
position()도 참조하십시오 .
void QTextFrameFormat::setRightMargin(qreal margin)
프레임의 오른쪽 margin 을 픽셀 단위로 설정합니다.
rightMargin()도 참조하십시오 .
void QTextFrameFormat::setTopMargin(qreal margin)
프레임의 상단 margin 을 픽셀 단위로 설정합니다.
topMargin()도 참조하십시오 .
void QTextFrameFormat::setWidth(const QTextLength &width)
프레임의 테두리 사각형의 width 를 설정합니다.
width() 및 QTextLength도 참조하십시오 .
void QTextFrameFormat::setWidth(qreal width)
프레임 테두리 사각형의 너비를 지정된 고정 너비 width 로 설정하는 편리한 메서드입니다.
이것은 오버로드된 함수입니다.
qreal QTextFrameFormat::topMargin() const
프레임의 상단 여백 너비를 픽셀 단위로 반환합니다.
setTopMargin()도 참조하십시오 .
QTextLength QTextFrameFormat::width() const
프레임의 테두리 사각형의 너비를 반환합니다.
setWidth() 및 QTextLength도 참조하십시오 .
© 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.