このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
mlreportgen.dom.MATLABTable クラス
名前空間: mlreportgen.dom
スーパークラス: mlreportgen.dom.FormalTable
MATLAB table
説明
mlreportgen.dom.MATLABTable
クラスのオブジェクトを使用して MATLAB® table を DOM table に変換します。
mlreportgen.dom.MATLABTable
クラスは handle
クラスです。
クラス属性
HandleCompatible | true |
ConstructOnLoad | true |
作成
説明
プロパティ
BackgroundColor
— 背景色
[]
(既定値) | 文字ベクトル | string スカラー
CSS の色名または 16 進数の RGB 値で構成される背景色。文字ベクトルまたは string スカラーとして指定します。
CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywordsを参照してください。
16 進数の RGB 書式を指定するには、最初の文字として
#
を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、"#0000ff"
は青を指定します。
メモ
BackgroundColor
プロパティを設定すると、mlreportgen.dom.BackgroundColor
書式オブジェクトが Style
プロパティに追加されます。BackgroundColor
プロパティを空の値に設定すると、そのオブジェクトは削除されます。
例: "blue"
例: "#0000ff"
属性:
NonCopyable | true |
データ型: char
| string
Body
— テーブル本体
mlreportgen.dom.TableBody
オブジェクト
テーブル コンストラクターは、mlreportgen.dom.TableBody
オブジェクトを作成して、形式的テーブルを構築するときにこのプロパティに割り当てます。このプロパティを後で設定することはできません。ただし、テーブル本体にコンテンツを追加し、このプロパティを使ってテーブル本体のプロパティを設定できます。
属性:
SetAccess | protected |
NonCopyable | true |
Border
— 描画する境界線のタイプ
"solid"
| "single"
| "dashed"
| "none"
| ... | ...
描画する境界線のタイプ。次の表のいずれかの値として指定します。
境界線の値 | 説明 | サポートされる出力タイプ |
---|---|---|
| 破線 | HTML、PDF、Word |
| 斜めの破線と点が交互に入った線 | Word |
| 破線間に小さい隙間がある破線 | Word |
| 点線 | HTML、PDF、Word |
| 点と破線が交互に入った線 | Word |
| 2 つの点と 1 本の破線が交互に入った線 | Word |
| 二重線 | HTML、PDF、Word |
| 二重波線 | Word |
| 3D 効果溝付き線 | HTML、PDF |
| 線なし 境界線タイプ | HTML、PDF |
| 3D 効果線 | HTML、PDF、Word |
| 線なし 境界線タイプ | HTML、PDF、Word |
| 3D 効果線 | HTML、PDF、Word |
| 3D 効果突起付き線 | HTML、PDF |
| 一重線 | Word |
| 一重線 | HTML、PDF |
| 太い線 | Word |
| 太い破線と細い破線が交互に入った隙間の大きい破線 | Word |
| 太い破線と細い破線が交互に入った隙間が中程度の破線 | Word |
| 太い破線と細い破線が交互に入った隙間の小さい破線 | Word |
| 細い破線と太い破線が交互に入った隙間が中程度の破線 | Word |
| 細い破線と太い破線が交互に入った隙間が中程度の破線 | Word |
| 細い破線と太い破線が交互に入った隙間の小さい破線 | Word |
| 細い破線と太い破線が交互に入った隙間の大きい破線 | Word |
| 細い破線と太い破線が交互に入った隙間が中程度の破線 | Word |
| 細い破線と太い破線が交互に入った隙間の小さい破線 | Word |
| エンボス加工した効果線 | Word |
| 彫り込み効果線 | Word |
| 三重線 | Word |
| 波線 | Word |
属性:
NonCopyable | true |
データ型: char
| string
BorderCollapse
— 隣接したセルの境界線を単一境界線に折りたたむ (HTML のみ)
[] (ブラウザーにより定義) | "on"
| "off"
"on"
の値は、隣接したセルの境界線を単一境界線に折りたたみます。"off"
の値は、隣接したセルの境界線を保持します。
メモ
このプロパティは、HTML ドキュメントにのみ適用されます。
属性:
NonCopyable | true |
データ型: char
| string
BorderColor
— 境界線の色
[]
(既定値) | 文字ベクトル | string スカラー
境界線の色。CSS の色名 (https://www.w3.org/wiki/CSS/Properties/color/keywordsを参照) または #RRGGBB
形式の 16 進数の RGB (トゥルーカラー) 値で構成される文字ベクトルまたは string スカラーとして指定します。
例: 'blue'
例: '#0000ff'
属性:
NonCopyable | true |
データ型: char
| string
BorderWidth
— テーブルの境界線幅
"px"
| "cm"
| "in"
| ...
テーブルの境界線幅。valueUnits
の形式で指定します。ここで、Units
は単位の略語です。有効な略語を以下に示します。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
例: "2pt"
属性:
NonCopyable | true |
データ型: char
| string
ColSep
— 列を分ける線のスタイル
"none"
| "solid"
| "dot"
| ...
テーブルまたはテーブル セクションの列を分ける線のスタイル。string スカラーまたは文字ベクトルとして指定します。有効なエントリの表については、Border
プロパティを参照してください。
属性:
NonCopyable | true |
データ型: char
| string
ColSepColor
— 列を分ける線の色
[]
(既定値) | 文字ベクトル | string スカラー
列を分ける線の色。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。
CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywordsを参照してください。
16 進数の RGB 書式を指定するには、最初の文字として
#
を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、"#0000ff"
は青を指定します。
例: "blue"
例: "#0000ff"
属性:
NonCopyable | true |
データ型: char
| string
ColSepWidth
— テーブル列を分ける線の幅
[]
(既定値) | 文字ベクトル | string スカラー
テーブル列を分ける線の幅。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。有効な Units
の略語は次のとおりです。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
例: "10pt"
属性:
NonCopyable | true |
データ型: char
| string
ColSpecGroups
— テーブル列のグループのプロパティ
[]
(既定値) | mlreportgen.dom.TableColSpecGroup
オブジェクトの配列
列のグループの幅、配置、およびその他のプロパティを指定する mlreportgen.dom.TableColSpecGroup
オブジェクトの配列。最初のオブジェクトが列の最初のグループに、2 番目のオブジェクトが 2 番目のグループに適用されます。以下同様に続きます。TableColSpecGroup
オブジェクトの Span
プロパティを使用して、各グループに属する列数を指定します。たとえば、最初のオブジェクトは、範囲が 2 の場合、最初の 2 つの列に適用されます。2 番目のグループは、範囲が 3 の場合、次の 3 つの列に適用されます。以下同様に続きます。
属性:
NonCopyable | true |
FlowDirection
— テキストの記述方向
[]
(既定値) | "ltr"
| "rtl"
テキストが記述される方向。以下のいずれか 1 つを値として指定します。
"ltr"
— テキストが左から右へ記述される"rtl"
— テキストが右から左へ記述される
属性:
NonCopyable | true |
データ型: char
| string
Footer
— このテーブルのフッター
mlreportgen.dom.TableFooter
オブジェクト
テーブル コンストラクターは、テーブル フッター オブジェクトを作成して、形式的テーブルを構築するときにこのプロパティに割り当てます。このプロパティを後で設定することはできません。ただし、テーブル本体にコンテンツを追加し、このプロパティを使ってテーブル本体のプロパティを設定できます。
属性:
SetAccess | private |
Transient | true |
NonCopyable | true |
HAlign
— このテーブルの水平方向の配置
[]
(既定値) | "center"
| "left"
| "right"
このテーブルの水平方向の配置。以下のいずれかの値として指定します。
"center"
"left"
"right"
メモ
PDF 出力でテーブルが大きい場合にオーバーフローしないようにするには、Width
プロパティを設定します。
属性:
NonCopyable | true |
データ型: char
| string
Header
— テーブル ヘッダー
mlreportgen.dom.TableHeader
オブジェクト
テーブル コンストラクターは、テーブル ヘッダー オブジェクトを作成して、形式的テーブルを構築するときにこのプロパティに割り当てます。このプロパティを後で設定することはできません。ただし、テーブル本体にコンテンツを追加し、このプロパティを使ってテーブル本体のプロパティを設定できます。
属性:
SetAccess | private |
Transient | true |
NonCopyable | true |
HeaderRule
— 見出しの水平方向のルール
mlreportgen.dom.HorizontalRule
オブジェクト
見出しの水平方向のルール。mlreportgen.dom.HorizontalRule
オブジェクトとして指定します。
属性:
NonCopyable | true |
KeepWithinPage
— テーブルのコンテンツを同一ページ内に保持するかどうか
[]
(既定値) | true
または 1
| false
または 0
テーブルのコンテンツを同一ページ内に保持するかどうか。数値または logical の 1
(true
) または 0
(false
) として指定します。既定値は空で、true
と等価です。
属性:
NonCopyable | true |
データ型: logical
NCols
— 列数
整数
列数。整数として指定します。
属性:
SetAccess | private |
NonCopyable | true |
データ型: uint64
OuterLeftMargin
— テーブルの左余白
[]
(既定値) | 文字ベクトル | string スカラー
テーブルの左余白。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。有効な略語を以下に示します。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
例: "10pt"
属性:
NonCopyable | true |
データ型: char
| string
RowNamesRule
— 行名の列を有効にするかどうか
logical
行の名前を含む最初の列を有効にするかどうか。logical として指定します。MATLAB table オブジェクトは行の名前を定義しなければなりません。
属性:
NonCopyable | true |
データ型: logical
RowSep
— 行を分ける線のスタイル
[]
(既定値) | 文字ベクトル | string スカラー
テーブルの行を分ける線のスタイル。文字ベクトルまたは string スカラーとして指定します。
使用可能な値の説明については、Border
プロパティの説明を参照してください。
属性:
NonCopyable | true |
データ型: char
| string
RowSepColor
— テーブル行を分ける線の色
[]
(既定値) | 文字ベクトル | string スカラー
テーブル行を分ける線の色。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。
CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywordsを参照してください。
16 進数の RGB 書式を指定するには、最初の文字として
#
を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、"#0000ff"
は青を指定します。
例: "blue"
例: "#0000ff"
属性:
NonCopyable | true |
データ型: char
| string
RowSepWidth
— 行の区切りの幅
[]
(既定値) | 文字ベクトル | string スカラー
行の区切りの幅。valueUnits
の形式で指定します。ここで、Units
は単位の略語です。有効な略語を以下に示します。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
例: "5pt"
属性:
NonCopyable | true |
データ型: char
| string
Width
— テーブルの幅
[]
(既定値) | 文字ベクトル | string スカラー
valueUnits
形式をもつ、ページ幅 (Word レポートの余白を引いたもの) に対する割合 (たとえば、'100%'
)、または測定単位の数値。Units
は単位の略語です。有効な略語を以下に示します。
px
— ピクセルcm
— センチメートルin
— インチmm
— ミリメートルpc
— パイカpt
— ポイント%
— 割合
例: "5pt"
属性:
NonCopyable | true |
データ型: char
| string
TableEntriesStyle
— テーブル エントリに使用するスタイル
[]
(既定値) | 書式オブジェクトの cell 配列
テーブル エントリに使用するスタイル。書式オブジェクトの cell 配列として指定します。
メモ
このプロパティで指定されたスタイルは、テーブル エントリのコンテンツに適用され、エントリ自体には適用されません。たとえば、このプロパティを使用してテーブル エントリのフォント サイズを定義できますが、エントリの境界線のタイプや色を定義することはできません。境界線を指定するには、各エントリの Style
プロパティを設定する必要があります。
メモ
このプロパティの以前の設定を誤って上書きしないように注意してください。たとえば、このテーブルの TableEntriesHAlign
プロパティを設定すると、HAlign
書式オブジェクトがこのプロパティに追加されます。このプロパティが上書きされないようにするには、このプロパティに書式を追加する他のテーブル プロパティを設定する前に、このプロパティを設定する必要があります。
属性:
NonCopyable | true |
データ型: cell
TableEntriesInnerMargin
— テーブル エントリの内側の余白
[]
(既定値) | 文字ベクトル | string スカラー
内側の余白はテーブル セルのコンテンツとセル境界線間の余白であり、形式は valueUnits
です。ここで、Units
は単位の略語です。有効な略語を以下に示します。
"px"
— ピクセル"cm"
— センチメートル"in"
— インチ"mm"
— ミリメートル"pc"
— パイカ"pt"
— ポイント
属性:
NonCopyable | true |
データ型: char
| string
StyleName
— ドキュメントまたはドキュメント パーツのスタイル シートのスタイル
[]
(既定値) | 文字ベクトル | string スカラー
このテーブルを追加するドキュメントまたはドキュメント パーツのスタイル シートで指定したスタイルの名前。文字ベクトルまたは string スカラーとして指定します。
StyleName
プロパティで指定されたスタイルは、このテーブルを追加するドキュメントまたはドキュメント パーツのスタイルシートで定義されていなければなりません。指定されたスタイルは、この MATLABTable
オブジェクトの Style
プロパティで指定された書式を除いて、出力ドキュメントでのテーブルの外観を定義します。Style
プロパティで指定された書式オブジェクトは、スタイルシートで定義された書式をオーバーライドします。
形式的テーブル セクションの StyleName
プロパティを設定できます。StyleName
の設定は、形式的テーブルによって指定したスタイルをオーバーライドします。ただし、Word ドキュメントにこれを行う場合は、セクションで各列の幅を明示的に指定して確実にすべてのセクションを同じ幅にしなければなりません。HTML および PDF とは異なり、Word には形式的テーブルの組み込みサポートはありません。これを処理するために、DOM インターフェイスでは、セクションごとに 3 行 1 列のテーブルに組み込んだ 3 つのテーブルとして形式的テーブルを表します。
属性:
NonCopyable | true |
データ型: char
| string
Style
— 書式指定
{}
(既定値) | 書式オブジェクトの配列
このドキュメント要素オブジェクトの書式指定。書式オブジェクトの配列として指定します。このプロパティで指定された書式は、この要素の StyleName
プロパティで指定された対応する書式をオーバーライドします。この要素に適用されない書式は無視されます。
属性:
NonCopyable | true |
データ型: cell
CustomAttributes
— ドキュメント要素のカスタム属性
[]
(既定値) | mlreportgen.dom.CustomAttribute
オブジェクトの配列
このドキュメント要素のカスタム属性。mlreportgen.dom.CustomAttribute
オブジェクトの配列として指定します。カスタム属性は、このオブジェクトが追加されるドキュメント要素の出力形式でサポートされていなければなりません。
属性:
NonCopyable | true |
Parent
— mlreportgen.dom.MATLABTable
オブジェクトの親
ドキュメント要素オブジェクト
mlreportgen.dom.MATLABTable
オブジェクトの親。ドキュメント要素オブジェクトとして指定します。ドキュメント要素の親は 1 つでなければなりません。
属性:
SetAccess | private |
NonCopyable | true |
Children
— mlreportgen.dom.MATLABTable
オブジェクトの子
ドキュメント要素オブジェクトの配列
mlreportgen.dom.MATLABTable
オブジェクトの子。ドキュメント要素オブジェクトの配列として指定します。このプロパティには、append
メソッドを使用して追加されたドキュメント要素オブジェクトが含まれます。
属性:
SetAccess | private |
NonCopyable | true |
Tag
— mlreportgen.dom.MATLABTable
オブジェクトのタグ
文字ベクトル | string スカラー
mlreportgen.dom.MATLABTable
オブジェクトのタグ。文字ベクトルまたは string スカラーとして指定します。DOM API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID
という形式です。ここで、CLASS
はオブジェクト クラスです。ID
はオブジェクトの Id
プロパティの値です。独自のタグ値を指定すると、ドキュメント生成中に問題が発生したときにどこを確認すればよいかを特定しやすくなります。
属性:
NonCopyable | true |
データ型: char
| string
Id
— mlreportgen.dom.MATLABTable
オブジェクトの識別子
文字ベクトル | string スカラー
mlreportgen.dom.MATLABTable
オブジェクトのオブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。DOM API は、ドキュメント要素オブジェクトの作成時にセッション固有識別子を生成します。Id
には独自の値を指定できます。
属性:
NonCopyable | true |
データ型: char
| string
メソッド
パブリック メソッド
メソッド | 目的 |
---|---|
| テーブルにテーブル エントリの行を追加します。 |
| テーブルをコピーします。 |
例
MATLAB table からのテーブルの作成
この例では、行名をもつ MATLAB table から DOM table を作成します。この例では、DOM table を含む 2 つのレポートを生成します。最初のレポートでは、テーブルの行名の列にラベルがありません。2 番目のレポートでは、行名の列にラベルがあります。
患者の年齢、体重、身長を表示する MATLAB table を作成します。RowNames
オプションを使用して、患者の姓で各行を識別します。
LastName = {'Sanchez';'Johnson';'Lee';'Diaz';'Brown'}; Age = [38;43;38;40;49]; Weight = [176;163;131;133;119]; Height = [71;69;64;67;64]; mltable = table(Age,Weight,Height,'RowNames',LastName)
mltable=5×3 table
Age Weight Height
___ ______ ______
Sanchez 38 176 71
Johnson 43 163 69
Lee 38 131 64
Diaz 40 133 67
Brown 49 119 64
この MATLAB table には 5 つの行と 3 つの列があります。行名は table の一部ではありません。それらは table のプロパティに格納されます。
MATLAB
table から mlreportgen.dom.MATLABTable
オブジェクトを作成します。
import mlreportgen.dom.*
mltableObj = MATLABTable(mltable);
ドキュメントを作成し、MATLABTable
オブジェクトをドキュメントに追加します。ドキュメントを閉じて表示します。
d = Document('MyMATLABTable1','docx'); append(d,mltableObj); close(d); rptview(d);
生成されたレポートのテーブルは次のようになります。
DOM table は、ヘッダーと本体をもつ形式的テーブルです。このテーブルには 5 つの行と 4 つの列があります。最初の列は、MATLAB table の行名で構成されています。
レポートを再度生成します。今回は行名の列にラベルを使用します。ラベルを指定するには、テーブル ヘッダー行の最初のエントリ内の空のテキストをラベル テキストに置き換えます。ラベルの下に線を引くには、MATLABTable
オブジェクトの RowNamesRule
プロパティを true
に設定します。
LastName = {'Sanchez';'Johnson';'Lee';'Diaz';'Brown'}; Age = [38;43;38;40;49]; Weight = [176;163;131;133;119]; Height = [71;69;64;67;64]; mltable = table(Age,Weight,Height,'RowNames',LastName); import mlreportgen.dom.* mltableObj = MATLABTable(mltable); th = mltableObj.Header; thentry11 = entry(th,1,1); thentry11.Children(1).Children(1).Content = 'Names'; mltableObj.RowNamesRule = true; d = Document('MyMATLABTable2','docx'); append(d,mltableObj); close(d); rptview(d);
生成されたレポートのテーブルは次のようになります。
バージョン履歴
R2016b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)