mlreportgen.ppt.TextBox クラス

名前空間: mlreportgen.ppt

テキスト ボックス

このページをすべて展開する

説明

プレゼンテーションに含めるテキスト ボックス。

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

作成

説明

textBoxObj = TextBox は、空のテキスト ボックス オブジェクトを作成します。

例

プロパティ

すべて展開する

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | 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

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

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

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

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

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

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

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

  • "single" — 一重水平線

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

  • "double" — 二重水平線

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

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

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

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

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

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

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

値説明
"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

背景色。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

テキストの垂直方向の配置。次の値のいずれかとして指定します。

値説明

"top"

上部に垂直方向に整列

"bottom"

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

"middle"

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

"topCentered"

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

"bottomCentered"

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

"middleCentered"

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

テキスト ボックスの幅。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"10px" は 10 ピクセルを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

テキスト ボックスの高さ。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"10px" は 10 ピクセルを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

テキストの書式設定。PPT 書式オブジェクトの cell 配列として指定します。以下の mlreportgen.ppt 書式オブジェクトを指定できます。

  • BackgroundColor オブジェクト

  • FontFamily オブジェクト

  • FontSize オブジェクト

  • Bold オブジェクト

  • FontColor オブジェクト

  • Italic オブジェクト

  • Underline オブジェクト

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: cell

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

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

データ型: cell

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

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

メソッド

すべて展開する

例

すべて折りたたむ

2 つのスライドをもつプレゼンテーションを作成します。

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

空白スライドを追加します。

blank = add(ppt,"Blank");

テキスト ボックスを作成し、その場所とサイズを定義します。

tb = TextBox();
tb.X = "1in";
tb.Y = "1in";
tb.Width = "8in";
tb.Height = "0.5in";

テキスト ボックスにテキストを追加し、空白スライドにテキスト ボックスを追加します。

add(tb,"This is the title of my blank slide");
add(blank,tb);

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

close(ppt);
rptview(ppt);

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

Generated presentation slide that reads "This is the title of my blank slide"

バージョン履歴

R2014b で導入

参考

| |

トピック