QTextTableFormat Class
QTextTableFormat 클래스는 QTextDocument.. . 더보기...
헤더: | #include <QTextTableFormat> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
상속합니다: | QTextFrameFormat |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextTableFormat은 서식 있는 텍스트 처리 API와 암시적으로 공유되는 클래스의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입됩니다.
공용 함수
QTextTableFormat() | |
Qt::Alignment | alignment() const |
bool | borderCollapse() const |
qreal | cellPadding() const |
qreal | cellSpacing() const |
void | clearColumnWidthConstraints() |
QList<QTextLength> | columnWidthConstraints() const |
int | columns() const |
int | headerRowCount() const |
bool | isValid() const |
void | setAlignment(Qt::Alignment alignment) |
void | setBorderCollapse(bool borderCollapse) |
void | setCellPadding(qreal padding) |
void | setCellSpacing(qreal spacing) |
void | setColumnWidthConstraints(const QList<QTextLength> &constraints) |
void | setHeaderRowCount(int count) |
상세 설명
표는 행과 열로 정렬된 셀 그룹입니다. 각 테이블은 적어도 하나의 행과 하나의 열을 포함합니다. 각 셀은 블록을 포함합니다. 서식 있는 텍스트 문서의 표는 이 클래스에 정의된 속성을 사용하여 서식이 지정됩니다.
표는 표의 정렬에 따라 상위 프레임 내에서 가로로 맞춤됩니다. 이는 alignment() 함수로 읽고 setAlignment()로 설정할 수 있습니다.
표 내의 셀은 셀 간격으로 구분됩니다. 셀 사이의 픽셀 수는 setCellSpacing()로 설정하고 cellSpacing()로 읽을 수 있습니다. 각 셀의 내용은 셀 패딩으로 둘러싸여 있습니다. 각 셀 가장자리와 내용 사이의 픽셀 수는 setCellPadding()로 설정하고 cellPadding()로 읽습니다.
표의 배경색은 background() 함수로 읽을 수 있으며 setBackground()로 지정할 수 있습니다. 각 셀의 배경색은 독립적으로 설정할 수 있으며, 패딩된 영역 내 셀의 색상을 제어합니다.
표 형식은 표의 열 너비를 제한하는 방법도 제공합니다. 열에는 고정 너비, 가변 너비 또는 사용 가능한 너비의 백분율을 할당할 수 있습니다( QTextLength 참조). columns () 함수는 제약 조건이 있는 열의 수를 반환하고 columnWidthConstraints() 함수는 테이블에 대해 정의된 제약 조건을 반환합니다. 이러한 수량은 새 제약 조건이 포함된 목록과 함께 setColumnWidthConstraints()를 호출하여 설정할 수도 있습니다. 제약 조건이 필요하지 않은 경우 clearColumnWidthConstraints()를 사용하여 제약 조건을 제거할 수 있습니다.
QTextTable, QTextTableCell, QTextLength 를참조하세요 .
멤버 함수 문서
QTextTableFormat::QTextTableFormat()
새 테이블 형식 객체를 생성합니다.
Qt::Alignment QTextTableFormat::alignment() const
테이블의 정렬을 반환합니다.
setAlignment()도 참조하세요 .
bool QTextTableFormat::borderCollapse() const
borderCollapse가 활성화된 경우 true를 반환합니다.
setBorderCollapse()도 참조하세요 .
qreal QTextTableFormat::cellPadding() const
표의 셀 패딩을 반환합니다. 셀 테두리와 내용물 사이의 거리를 나타냅니다.
setCellPadding()도 참조하세요 .
qreal QTextTableFormat::cellSpacing() const
표의 셀 간격을 반환합니다. 인접한 셀 사이의 거리를 설명합니다.
setCellSpacing()도 참조하세요 .
void QTextTableFormat::clearColumnWidthConstraints()
테이블의 열 너비 제약 조건을 지웁니다.
columnWidthConstraints() 및 setColumnWidthConstraints()도 참조하세요 .
QList<QTextLength> QTextTableFormat::columnWidthConstraints() const
이 테이블 형식에서 테이블의 열 모양을 제어하는 데 사용되는 제약 조건 목록을 반환합니다.
setColumnWidthConstraints()도 참조하세요 .
int QTextTableFormat::columns() const
테이블 형식으로 지정된 열의 수를 반환합니다.
int QTextTableFormat::headerRowCount() const
헤더를 정의하는 테이블의 행 수를 반환합니다.
setHeaderRowCount()도 참조하세요 .
bool QTextTableFormat::isValid() const
이 테이블 형식이 유효하면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
void QTextTableFormat::setAlignment(Qt::Alignment alignment)
테이블의 alignment 을 설정합니다.
alignment()도 참조하세요 .
void QTextTableFormat::setBorderCollapse(bool borderCollapse)
borderCollapse 을 활성화하면 다음과 같은 영향을 미칩니다:
- 표의 테두리와 격자는 CSS 표
border-collapse
:collapse
규칙에 따라 렌더링됩니다. border
속성을 최소값1
으로 설정하면 borderBrush 속성을 사용하여 1픽셀 단색의 내부 테이블 그리드와 지정된 대로 외부 테두리가 렌더링됩니다.- QTextTableCellFormat 의 다양한 테두리 스타일 속성을 사용하여 그리드를 사용자 정의하고 표의 테두리 및 그리드보다 우선 순위를 가질 수 있습니다.
- cellSpacing 속성은 무시됩니다.
- 인쇄 페이지 매김의 경우:
- 페이지에서 계속되는 열에는 상단 셀 테두리가 렌더링되지 않습니다.
- 반복되는 머리글 행에는 항상 아래쪽 셀 테두리가 렌더링됩니다.
borderCollapse 을 비활성화해도 QTextTableCellFormat 을 사용하여 셀 테두리를 스타일링할 수 있지만 스타일링은 셀의 프레임 내에서만 적용되므로 실제로는 그다지 유용하지 않을 수 있습니다.
borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle() 및 QTextTableCellFormat 를참조하세요 .
void QTextTableFormat::setCellPadding(qreal padding)
표에 padding 셀을 설정합니다. 셀의 테두리와 내용물 사이의 거리를 결정합니다.
cellPadding()도 참조하세요 .
void QTextTableFormat::setCellSpacing(qreal spacing)
표에 spacing 셀을 설정합니다. 이 속성은 인접한 셀 사이의 거리를 결정합니다.
borderCollapse 이 활성화된 경우 이 속성은 무시됩니다.
cellSpacing()도 참조하세요 .
void QTextTableFormat::setColumnWidthConstraints(const QList<QTextLength> &constraints)
테이블의 열 너비 constraints 를 설정합니다.
columnWidthConstraints() 및 clearColumnWidthConstraints()도 참조하세요 .
void QTextTableFormat::setHeaderRowCount(int count)
표의 첫 번째 count 행을 표 헤더로 선언합니다. 테이블 헤더 행은 테이블이 페이지 경계를 가로질러 분할될 때 반복됩니다.
headerRowCount()도 참조하세요 .
© 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.