Main Content

形式的テーブルの作成

DOM API 形式的テーブルには、ヘッダー セクションと本体セクション、フッター セクションがあります。形式的テーブルは、ヘッダーやフッターが複数行に及ぶ場合に便利です。ヘッダー セクション、本体セクション、およびフッター セクションが独立していることで、他のセクションに関わりなく、ヘッダー、本体、またはフッターに行を追加し、書式設定することが容易になります。レポート内で作成可能な他の種類のテーブルについては、作成するテーブルの種類の選択を参照してください。テーブルの書式設定の詳細については、Format Tablesを参照してください。

形式的テーブルは、mlreportgen.dom.FormalTable オブジェクトで表されます。ヘッダー セクション、本体セクション、およびフッター セクションは、mlreportgen.dom.TableHeader オブジェクト、mlreportgen.dom.TableBody オブジェクト、および mlreportgen.dom.TableFooter オブジェクトでそれぞれ表されます。各セクションには、行とテーブル エントリがあります。行は、mlreportgen.dom.TableRow オブジェクトで表されます。本体セクションとフッター セクションのエントリは、mlreportgen.dom.TableEntry オブジェクトで表されます。ヘッダーのエントリは、mlreportgen.dom.TableHeaderEntry オブジェクトまたは mlreportgen.dom.TableEntry オブジェクトで表されます。

MATLAB® 配列から形式的テーブルのセクションを作成できます。TableRow オブジェクトと TableEntry オブジェクトまたは TableHeaderEntry オブジェクトを作成する必要がないため、この方法が最も簡単です。TableRow オブジェクトと TableEntry オブジェクトまたは TableHeaderEntry オブジェクトからテーブルを構築することで、セクションを作成することもできます。この方法は、エントリが複数の列または行にまたがる場合など、書式設定の要件が複雑な場合に便利です。方法は組み合わせることができます。たとえば、配列からテーブル本体を作成し、行とエントリからヘッダーを作成することができます。

MATLAB 配列からの形式的テーブルの作成

mlreportgen.dom.FormalTable コンストラクターを使用して、形式的テーブルを作成します。コンストラクターは、本体セクション、ヘッダー セクション、およびフッター セクションに関する MATLAB データの 2 次元配列または cell 配列を、必要に応じて受け入れます。mlreportgen.dom.FormalTable リファレンス ページの引数 headerbody、および footer を参照してください。string 配列から形式的テーブルのヘッダーを作成し、cell 配列から形式的テーブルの本体を作成する例については、cell 配列からのテーブルの作成を参照してください。

行とエントリからの形式的テーブルの作成

テーブル エントリをテーブル行に追加し、行をセクションに追加することで、形式的テーブルのヘッダー セクション、本体セクション、またはフッター セクションを作成できます。

ヘッダー エントリを作成するには、mlreportgen.dom.TableHeaderEntry オブジェクトまたは mlreportgen.dom.TableEntry オブジェクトを使用できます。配列からヘッダーを作成する場合、DOM API はエントリを TableHeaderEntry オブジェクトとして作成します。HTML レポートで、DOM API は TableHeaderEntry オブジェクトを th (テーブル ヘッダー セル) 要素としてレンダリングします。このレンダリングにおけるテーブル エントリの書式設定は、ブラウザーに依存します。Word や PDF のレポートの場合、DOM API は既定で TableHeaderEntry オブジェクトを Word または PDF の書式なしのテーブル エントリ要素としてレンダリングします。TableHeaderEntry オブジェクトのプロパティを使用して、すべての出力タイプに対して生成されたテーブル エントリを書式設定できます。たとえば、これらのプロパティを使用して、HTML レポートでブラウザーの書式設定をオーバーライドできます。

テーブル行とテーブル エントリから形式的テーブルのセクションを作成するには、FormalTableappendHeaderRowappend、および appendFooterRow メソッドを使用して、テーブルのヘッダー セクション、本体セクション、またはフッター セクションに行を追加します。または、FormalTable オブジェクトの HeaderBody、または Footer プロパティを使用してセクションにアクセスし、append メソッドを使用してセクションに行を追加することもできます。

エントリと行からヘッダーを作成する例については、Span a Table Entry Across Rows and ColumnsFormal Table を参照してください。

参考

| | | | | | |

関連するトピック