이 페이지에서

QTextFrameFormat Class

QTextFrameFormat 클래스는 QTextDocument 내의 프레임에 대한 서식 정보를 제공합니다. 더 보기...

헤더: #include <QTextFrameFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
상속: QTextFormat
상속받는 클래스:

QTextTableFormat

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

공개 유형

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_None0
QTextFrameFormat::BorderStyle_Dotted1
QTextFrameFormat::BorderStyle_Dashed2
QTextFrameFormat::BorderStyle_Solid3
QTextFrameFormat::BorderStyle_Double4
QTextFrameFormat::BorderStyle_DotDash5
QTextFrameFormat::BorderStyle_DotDotDash6
QTextFrameFormat::BorderStyle_Groove7
QTextFrameFormat::BorderStyle_Ridge8
QTextFrameFormat::BorderStyle_Inset9
QTextFrameFormat::BorderStyle_Outset10

borderStyle() 및 FrameBorderStyle도 참조하십시오 .

enum QTextFrameFormat::Position

이 열거형은 프레임이 주변 텍스트에 대해 어떤 위치에 있는지를 나타냅니다.

상수값
QTextFrameFormat::InFlow0
QTextFrameFormat::FloatLeft1
QTextFrameFormat::FloatRight2

position() 및 CssFloat도 참조하십시오 .

멤버 함수 문서

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.