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()
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)

詳細説明

表は、行と列に並べられたセルのグループです。各テーブルは少なくとも1つの行と1つの列を含む。各セルにはブロックが含まれます。リッチテキスト文書内の表は、このクラスで定義されたプロパティを使用してフォーマットされます。

表は、表のアライメントに従って親フレーム内で水平方向に両端揃えされます。これはalignment() 関数で読み込み、setAlignment() で設定できます。

テーブル内のセルは、セル間隔によって区切られます。セル間のピクセル数は、setCellSpacing ()で設定し、cellSpacing ()で読み込む。各セルの内容はセル・パディングで囲まれます。各セルの端とその内容の間のピクセル数は、setCellPadding ()で設定し、cellPadding ()で読み込む。

表の背景色はbackground() 関数で読み込むことができ、setBackground() で指定することができる。各セルの背景色は独立して設定でき、パディングされた領域内のセルの色を制御します。

表形式では、表の列の幅を制限することもできます。列の幅は、固定幅、可変幅、または利用可能な幅に対するパーセンテージを割り当てることができます(QTextLength を参照)。columns ()関数は制約を持つ列の数を返し、columnWidthConstraints ()関数はテーブルに定義された制約を返します。これらの量は、新しい制約を含むリストを指定してsetColumnWidthConstraints() を呼び出すことでも設定できます。制約が不要な場合は、clearColumnWidthConstraints() を使用して制約を削除できます。

QTextTableQTextTableCell 、および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 tableborder-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.