Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

mlreportgen.ppt.Table クラス

名前空間: mlreportgen.ppt

プレゼンテーション内のテーブル

説明

mlreportgen.ppt.Table クラスのオブジェクトを使用して、PPT API プレゼンテーションにテーブルを含めます。

次のいずれかの方法を使用してテーブルを作成します。

  • 空のテーブルを作成し、各列にテーブル エントリがあるテーブル行を追加する。

  • テーブル コンテンツを指定する配列または cell 配列からテーブルを作成する。

テーブルを作成した後は、テーブルに行を追加し、各テーブル行にエントリを追加できます。

mlreportgen.ppt.Table クラスは handle クラスです。

クラス属性

HandleCompatible
true
ConstructOnLoad
true

クラス属性の詳細については、クラスの属性を参照してください。

作成

説明

tableObj = mlreportgen.ppt.Table() は、空の Table オブジェクトを作成します。

tableObj = mlreportgen.ppt.Table(nCols) は、NCols プロパティを nCols に設定します。

tableObj = mlreportgen.ppt.Table(tableValues) は、tableValues で指定されたコンテンツをもつテーブルを返します。

tableObj = mlreportgen.ppt.Table(tableValues,styleName) は、指定されたコンテンツを含むテーブルを返し、StyleName プロパティを styleName に設定します。有効なスタイル名のリストを取得するには、mlreportgen.ppt.Presentation オブジェクトの getTableStyleNames メソッドを使用します。

入力引数

すべて展開する

テーブルの値。数値、文字ベクトル、string スカラー、または mlreportgen.ppt.Paragraph オブジェクトからなる 2 次元数値配列、2 次元 categorical 配列、または 2 次元 cell 配列として指定します。

プロパティ

すべて展開する

テーブルの列数。整数として指定します。このプロパティは読み取り専用です。列数を指定するには、構文 mlreportgen.ppt.Table(nCols) を使用してテーブルを作成します。そうでない場合、列数は、テーブルのコンテンツに基づきコンストラクター Table によって決定されます。テーブルに行を追加したり、行にエントリを追加したりして、列の数が変更された場合、NCols プロパティの値が更新されます。行によってエントリの数が異なる場合、テーブル エントリの数が最も多い行によってテーブルの列数が決まります。

テーブルのスタイル名。文字ベクトルまたは string スカラーとして指定します。有効なスタイル名のリストを取得するには、mlreportgen.ppt.Presentation オブジェクトの getTableStyleNames メソッドを使用します。

テーブルの背景色。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。

  • CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

  • 16 進数の RGB 書式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、'#0000ff' は青を指定します。

テーブル列の幅、配置、およびその他の書式設定プロパティを指定する mlreportgen.ppt.ColSpec オブジェクトの配列。最初のオブジェクトが最初の列に適用され、2 番目のオブジェクトが 2 番目の列に適用されます。以下同様に続きます。

テーブル列の配置方向。文字ベクトルまたは string スカラーとして指定します。次のいずれかの値を指定します。

  • 'LeftToRight' — 左から右の列順

  • 'RightToLeft' — 右から左の列順

テーブル列の並べ替えを参照してください。

境界線のスタイル。文字ベクトルまたは string スカラーとして指定します。次のいずれかの値を指定します。

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

境界線の色。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。

  • CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

  • 16 進数の RGB 書式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、'#0000ff' は青を指定します。

境界線の幅。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'3pt' は 3 ポイントを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

列区切りのスタイル。文字ベクトルまたは string スカラーとして指定します。次のいずれかの値を指定します。

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

列区切りの色。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。

  • CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

  • 16 進数の RGB 書式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、'#0000ff' は青を指定します。

列区切りの幅。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'3pt' は 3 ポイントを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

行区切りのスタイル。文字ベクトルまたは string スカラーとして指定します。次のいずれかの値を指定します。

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

行区切りの色。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。

  • CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

  • 16 進数の RGB 書式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、'#0000ff' は青を指定します。

行区切りの幅。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'3pt' は 3 ポイントを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

このテーブル内のテキストのフォント ファミリ。文字ベクトルまたは string スカラーとして指定します。Microsoft® PowerPoint® のフォント リストに表示されるフォントを指定します。フォントの一覧を表示するには、PowerPoint の [ホーム] タブの [フォント] グループで、フォントの右にある矢印をクリックします。

コンプレックス スクリプト用のフォント ファミリ。文字ベクトルまたは string スカラーとして指定します。アラビア語やアジア言語など、テキストをレンダリングするためにコンプレックス スクリプトを必要とするロケールで代わりに使用するフォント ファミリを指定します。

このテーブル内のテキストのフォント カラー。CSS の色名または 16 進数の RGB 値で構成される文字ベクトルまたは string スカラーとして指定します。

  • CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

  • 16 進数の RGB 書式を指定するには、最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。たとえば、'#0000ff' は青を指定します。

このテーブル内のテキストのフォント サイズ。数値とそれに続く測定単位で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'11pt' は 11 ポイントを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

テーブル名。文字ベクトルまたは string スカラーとして指定します。

テーブルの位置の左上の x 座標。数値とそれに続く測定単位で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'5in' は 5 インチを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

テーブルの位置の左上の y 座標。数値とそれに続く測定単位で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'5in' は 5 インチを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

テーブルの幅。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'5in' は 5 インチを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

テーブルの高さ。数値とそれに続く測定単位の略語で構成される文字ベクトルまたは string スカラーとして指定します。たとえば、'5in' は 5 インチを指定します。有効な略語を以下に示します。

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

テーブルの高さが指定され、行の高さが指定されていない任意の行がある場合、すべての行の高さが同じになります。行の高さは、テーブルの高さを行数で除算することによって決まります。少なくとも 1 つの行の高さが指定されている場合、PPT API はテーブルの高さを無視します。高さの指定がない行の高さは Microsoft PowerPoint が決定します。

テーブルの書式設定。PPT 書式オブジェクトの cell 配列として指定します。Table オブジェクトに適用されない書式は無視されます。

このオブジェクトの子要素。PPT オブジェクトの cell 配列として指定します。このプロパティは読み取り専用です。

このオブジェクトの親。PPT オブジェクトとして指定します。このプロパティは読み取り専用です。

この PPT API オブジェクトのタグ。文字ベクトルまたは string スカラーとして指定します。セッション固有タグは、このオブジェクト作成の一環として生成されます。生成されたタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。

独自のタグ値を指定すると、プレゼンテーションの生成中に問題が発生した箇所の特定を容易にできます。

この PPT API オブジェクトの ID。文字ベクトルまたは string スカラーとして指定します。セッション固有 ID は、オブジェクト作成の一環として生成されます。ID を指定して、生成された ID を置き換えることができます。

メソッド

すべて展開する

すべて折りたたむ

mlreportgen.ppt.Table オブジェクトを使用して、プレゼンテーションにテーブルを含めます。

プレゼンテーションを作成します。

import mlreportgen.ppt.*

ppt = Presentation('myTablePresentation.pptx');
open(ppt);

slide1 = add(ppt,'Title and Table');
slide2 = add(ppt,'Title and Table');

cell 配列からテーブルを作成します。

table1 = Table({'a','b';'c','d'});
table1.Children(1).FontColor = 'red';
table1.Children(2).FontColor = 'green';

find メソッドを使用して、Name プロパティが Table に設定されたオブジェクトを含むスライドを検索します。既定の PPT API Title and Table レイアウトのスライドには、Table オブジェクトがあります。

contents = find(ppt,'Table');

最初のスライドのコンテンツを table1 に置き換えます。

replace(contents(1),table1);

MATLAB® 関数 magic の出力から 2 番目のテーブルを作成します。

table2 = Table(magic(9));

2 番目のスライドのコンテンツを table2 に置き換えます。

replace(contents(2),table2);

プレゼンテーションを閉じて表示します。

close(ppt);
rptview(ppt);

生成されたプレゼンテーションのスライドは次のようになります。

プレゼンテーションでテーブルの列の順序を指定するには、Table オブジェクトの FlowDirection プロパティを使用します。

プレゼンテーションを作成します。

import mlreportgen.ppt.*
ppt = Presentation('myFlowDirection.pptx');
open(ppt);

プレゼンテーションにスライドを追加します。

slide = add(ppt,'Title and Content');

テーブルを作成し、テーブルの配置方向を指定します。

t = Table({'entry(1,1)','entry(1,2)';'entry(2,1)','entry(2,2)'});
t.FlowDirection = 'RightToLeft';

スライドをテーブルに追加します。

replace(slide,'Content',t);

プレゼンテーションを閉じて表示します。

close(ppt);
rptview(ppt);

生成されたプレゼンテーションのスライドは次のようになります。

バージョン履歴

R2015b で導入