mlreportgen.ppt.ColSpec クラス

名前空間: mlreportgen.ppt

テーブル列の書式設定

説明

mlreportgen.ppt.ColSpec クラスのオブジェクトを使用して、PPT API プレゼンテーションのテーブル列のコンテンツを書式設定します。書式プロパティを設定するか、Style プロパティに書式オブジェクトを追加するか、またはその 2 つを組み合わせて、書式を指定します。プレゼンテーションの書式設定方法を参照してください。

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

クラス属性

ConstructOnLoad	true
HandleCompatible	true

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

作成

説明

colSpecObj = mlreportgen.ppt.ColSpec は、空のテーブル列指定オブジェクトを作成します。

colSpecObj = mlreportgen.ppt.ColSpec(colWidth) は、Width プロパティを colWidth に設定します。

プロパティ

Width — 列幅

[] (既定値) | 文字ベクトル | string スカラー

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

• "px" — ピクセル

• "cm" — センチメートル

• "in" — インチ

• "mm" — ミリメートル

• "pc" — パイカ

• "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

例: "2in"

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Bold — テキストに太字を使用するかどうか

[] (既定値) | 1 (true) | 0 (false)

テキストに太字を使用するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — テキストを太字でレンダリングする。

• 0 (false) — テキストを標準的な太さでレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Font — テキストのフォント ファミリ

[] (既定値) | 文字ベクトル | string スカラー

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

ComplexScriptFont — コンプレックス スクリプト用のフォント ファミリ

[] (既定値) | 文字ベクトル | string スカラー

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

FontColor — テキストのフォント カラー

[] (既定値) | 文字ベクトル | string スカラー

テキストのフォント カラー。CSS の色名または 16 進数の RGB 値を含む文字ベクトルまたは string スカラーとして指定します。

形式	値
CSS の色名	CSS の色名を指定します。CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。
16 進数の RGB 値	"#RRGGBB" の形式を使用します。最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。大文字と小文字のいずれも使用できます。

例: "red" は、CSS の色名を使用して赤色を指定します。

例: "#0000ff" は、16 進数の RGB 値を使用して青色を指定します。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

FontSize — テキストのフォント サイズ

[] (既定値) | 文字ベクトル | string スカラー

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

• "px" — ピクセル

• "cm" — センチメートル

• "in" — インチ

• "mm" — ミリメートル

• "pc" — パイカ

• "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Italic — テキストにイタリックを使用するかどうか

[] (既定値) | 1 (true) | 0 (false)

テキストにイタリックを使用するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — テキストをイタリックでレンダリングする。

• 0 (false) — テキストを直立体のテキストとしてレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Strike — テキストの取り消し線スタイル

[] (既定値) | "single" | "none" | "double"

テキストの取り消し線スタイル。次の値のいずれかとして指定します。

• "single" — 一重水平線

• "none" — 取り消し線なし

• "double" — 二重水平線

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Subscript — テキストを下付き文字として表示するかどうか

[] (既定値) | 1 (true) | 0 (false)

テキストを下付き文字として表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。Subscript が 1 (true) の場合、テキストは下付き文字としてレンダリングされます。Subscript が 0 (false) の場合、テキストは通常のテキストとしてレンダリングされます。

• 1 (true) — テキストを下付き文字としてレンダリングする。

• 0 (false) — テキストを通常のテキストでレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Superscript — ドキュメント要素を上付き文字として表示するかどうか

[] (既定値) | 1 (true) | 0 (false)

ドキュメント要素を上付き文字として表示するかどうか。logical の 1 (true) または 0 (false) として指定します。指定内容は以下のとおりです。

• 1 (true) — ドキュメント要素を上付き文字としてレンダリングする。

• 0 (false) — ドキュメント要素を通常のテキストでレンダリングする。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: logical

Underline — テキストの下線スタイル

[] (既定値) | "single" | "double" | ... | ...

テキストの下線スタイル。次の値のいずれかとして指定します。

値	説明
"single"	一重線の下線
"double"	二重線の下線
"heavy"	太線の下線
"words"	単語にのみ下線を引く (空白は除外)
"dotted"	点線の下線
"dottedheavy"	太点線の下線
"dash"	破線の下線
"dashheavy"	太破線の下線
"dashlong"	長破線の下線
"dashlongheavy"	長太破線の下線
"dotdash"	一点鎖線の下線
"dotdashheavy"	太一点鎖線の下線
"dotdotdash"	二点鎖線の下線
"dotdotdashheavy"	太二点鎖線の下線
"wavy"	波線の下線
"wavyheavy"	太波線の下線
"wavydouble"	二重波線の下線
"none"	下線なし

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

BackgroundColor — 背景色

[] (既定値) | 文字ベクトル | string スカラー

背景色。CSS の色名または 16 進数の RGB 値を含む文字ベクトルまたは string スカラーとして指定します。

形式	値
CSS の色名	CSS の色名を指定します。CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。
16 進数の RGB 値	"#RRGGBB" の形式を使用します。最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。大文字と小文字のいずれも使用できます。

BackgroundColor プロパティを設定すると、mlreportgen.ppt.BackgroundColor 書式オブジェクトが Style プロパティに追加されます。BackgroundColor プロパティを空の値に設定すると、そのオブジェクトは削除されます。

例: "red" は、CSS の色名を使用して赤色を指定します。

例: "#0000ff" は、16 進数の RGB 値を使用して青色を指定します。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

HAlign — コンテンツの水平方向の配置

[] (既定値) | "center" | "left" | ...

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

値	説明
"center"	中央揃え
"left"	左揃え
"right"	右揃え
"justified"	左揃えおよび右揃え (単語の間隔を均等にする)
"distributed"	左揃えおよび右揃え (文字の間隔を均等にする)
"thaiDistributed"	左揃えおよび右揃えされたタイ語テキスト (文字の間隔を均等にする)
"justifiedLow"	アラビア語テキストの行端揃え

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

VAlign — コンテンツの垂直方向の配置

[] (既定値) | "top" | "bottom" | ...

コンテンツの垂直方向の配置。次の値のいずれかとして指定します。

値	説明
"top"	上部に垂直方向に整列
"bottom"	テーブル エントリの下部に垂直方向に整列
"middle"	テーブル エントリの中央に垂直方向に整列
"topCentered"	テーブル エントリの上部に垂直方向に整列、かつテーブル エントリの中央に水平方向に整列
"bottomCentered"	テーブル エントリの下部に垂直方向に整列、かつテーブル エントリの中央に水平方向に整列
"middleCentered"	テーブル エントリの中央に垂直方向に整列、かつテーブル エントリの中央に水平方向に整列

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

TextOrientation — テキストの向き

[] (既定値) | "horizontal" | "down" | "up"

テキストの向き。次の値のいずれかとして指定します。

値	説明
"horizontal"	テキストの方向は水平です。
"down"	テキストの方向は垂直で、コンテンツが時計回りに 90 度回転します。
"up"	テキストの方向は垂直で、コンテンツが反時計回りに 90 度回転します。

列テキストの方向の指定を参照してください。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

Style — 列の書式設定

PPT 書式オブジェクトの cell 配列

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

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: cell

Parent — このオブジェクトの親

PPT API オブジェクト

このオブジェクトの親。PPT API オブジェクトとして指定します。PPT API オブジェクトの親は 1 つでなければなりません。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true

Children — このオブジェクトの子

PPT API オブジェクトの cell 配列

このオブジェクトの子要素。PPT API オブジェクトの cell 配列として指定します。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true

データ型: cell

Tag — タグ

文字ベクトル | string スカラー

タグ。文字ベクトルまたは string スカラーとして指定します。PPT API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。この値を使用すると、プレゼンテーションの生成中に問題が発生した箇所を容易に特定できるようになります。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Id — オブジェクト識別子

文字ベクトル | string スカラー

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。PPT API は、プレゼンテーション要素オブジェクトの作成時にセッション固有識別子を生成します。Id には独自の値を指定できます。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

例

テーブル列の書式の指定

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

import mlreportgen.ppt.*

ppt = Presentation("myColSpec.pptx");
open(ppt);
slide = add(ppt,"Title and Content");

テーブルを作成します。テーブルの最初の 2 列の幅と背景色を指定します。

t = Table(magic(12));
t.Style = {HAlign("center")};

colSpecs(2) = ColSpec("2in");
colSpecs(1) = ColSpec("1in");
colSpecs(1).BackgroundColor = "red";
colSpecs(2).BackgroundColor = "green";
t.ColSpecs = colSpecs;

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

replace(slide,"Content",t);

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

close(ppt);
rptview(ppt);

列テキストの方向の指定

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

import mlreportgen.ppt.*
ppt = Presentation("myTextOrientation.pptx");
open(ppt);

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

slide = add(ppt,"Title and Table");

テーブルを作成します。

table = Table({"Col 1","Col 2";"entry 1","entry 2"});
table.Height = "2in";
table.Style = [table.Style {VAlign("middleCentered")}];

mlreportgen.ppt.ColSpec オブジェクトを使用して、テーブル列の書式を定義します。最初の列について、テキストの方向が垂直で、反時計回りに 90 度回転していることを指定します。2 番目の列について、テキストの方向が垂直で、時計回りに 90 度回転していることを指定します。

colSpecs(1) = ColSpec("1in");
colSpecs(1).TextOrientation = "up";
colSpecs(2) = ColSpec("1in");
colSpecs(2).TextOrientation = "down";

ColSpec オブジェクトを Table オブジェクトに割り当てます。

table.ColSpecs = colSpecs;

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

replace(slide,"Table",table);

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

close(ppt);
rptview(ppt);

ヒント

• ColSpec オブジェクトの配列を作成するには、for ループを使用します。ループを使用したオブジェクト配列の作成を参照してください。

バージョン履歴

R2015b で導入

参考

mlreportgen.ppt.ColWidth | mlreportgen.ppt.Bold | mlreportgen.ppt.FontFamily | mlreportgen.ppt.FontColor | mlreportgen.ppt.FontSize | mlreportgen.ppt.Italic | mlreportgen.ppt.Strike | mlreportgen.ppt.Subscript | mlreportgen.ppt.Superscript | mlreportgen.ppt.Underline | mlreportgen.ppt.BackgroundColor | mlreportgen.ppt.HAlign | mlreportgen.ppt.VAlign

トピック

• テーブルの作成と書式設定
• プレゼンテーションの書式設定方法
• プレゼンテーション書式の継承