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 はRich Text Processing APIおよびImplicitly Shared Classes に含まれています。
注意:このクラスの関数はすべてリエントラントです。
パブリック関数
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() を使用して制約を削除できます。
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 table
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.