Main Content

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

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 に設定します。

プロパティ

すべて展開する

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

  • px — ピクセル (既定)

  • cm — センチメートル

  • in — インチ

  • mm — ミリメートル

  • pc — パイカ

  • pt — ポイント

列テキストに太字を使用するオプション。数値または logical の 1 (true) または 0 (false) として指定します。テキストを太字にするには、このプロパティを true または 1 に設定します。

列テキストのフォント ファミリ。文字ベクトルまたは 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 — ポイント

列テキストにイタリックを使用するオプション。数値または logical の 1 (true) または 0 (false) として指定します。Italictrue または 1 の場合、テキストはイタリックでレンダリングされます。Italicfalse または 0 の場合、テキストは正体 (直立) としてレンダリングされます。

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

  • 'single' — 一重水平線

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

  • 'double' — 二重水平線

列テキストを下付き文字としてレンダリングするオプション。1 (true) または 0 (false) の数値または logical として指定します。Subscripttrue または 1 の場合、テキストは下付き文字としてレンダリングされます。Subscriptfalse または 0 の場合、テキストは通常のテキストとしてレンダリングされます。

列テキストを上付き文字としてレンダリングするオプション。1 (true) または 0 (false) の数値または logical として指定します。Superscripttrue または 1 の場合、テキストは上付き文字としてレンダリングされます。Superscriptfalse または 0 の場合、テキストは通常のテキストとしてレンダリングされます。

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

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

背景色。CSS の色名または 16 進数の RGB 値として書式設定された、文字ベクトルまたは string スカラーとして指定します。

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

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

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

説明

'center'

中央揃え

'left'

左揃え

'right'

右揃え

'justified'

左揃えおよび右揃え (単語の間隔を均等にする)

'distributed'

左揃えおよび右揃え (文字の間隔を均等にする)

'thaiDistributed'

左揃えおよび右揃えされたタイ語テキスト (文字の間隔を均等にする)

'justifiedLow'

アラビア語テキストの行端揃え

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

説明

'top'

上部に垂直方向に整列

'bottom'

テーブル エントリの下部に垂直方向に整列

'middle'

テーブル エントリの中央に垂直方向に整列

'topCentered'

テーブル エントリの上部に垂直方向に整列、かつテーブル エントリの中央に水平方向に整列

'bottomCentered'

テーブル エントリの下部に垂直方向に整列、かつテーブル エントリの中央に水平方向に整列

'middleCentered'

テーブル エントリの中央に垂直方向に整列、かつテーブル エントリの中央に水平方向に整列

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

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

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

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

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

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

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

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

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

すべて折りたたむ

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

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);

バージョン履歴

R2015b で導入