QTextTableFormat Class
QTextTableFormatクラスは、QTextDocument の表のフォーマット情報を提供します。
| Header: | #include <QTextTableFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Inherits: | 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) |
詳細説明
表は、行と列に並べられたセルのグループです。各テーブルは少なくとも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
header関数は、ヘッダを定義する表の行数を返します。
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()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
