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 の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。

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

例: "blue"

例: "#0000ff"

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

テキストにイタリックを使用するかどうか。数値または logical の 1 (true) または 0 (false) として指定します。Italic が true または 1 の場合、テキストはイタリックでレンダリングされます。Italic が false または 0 の場合、テキストは直立体としてレンダリングされます。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

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

  • "single" — 一重水平線

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

  • "double" — 二重水平線

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: logical

テキストを上付き文字として表示するかどうか。数値または logical の 1 (true) または 0 (false) として指定します。Superscript が true または 1 の場合、テキストは上付き文字としてレンダリングされます。Superscript が false または 0 の場合、テキストは通常のテキストとしてレンダリングされます。

属性:

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 の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywordsを参照してください。

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

メモ

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

例: "blue"

例: "#0000ff"

属性:

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" — ポイント

メモ

PPT API が mlreportgen.ppt.TextBox オブジェクトを作成する際、このプロパティ値は英メートル単位 (EMU) で指定されます。このプロパティ値を設定する場合は、前述のリストのいずれかの単位を使用します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

メモ

PPT API が mlreportgen.ppt.TextBox オブジェクトを作成する際、このプロパティ値は英メートル単位 (EMU) で指定されます。このプロパティ値を設定する場合は、前述のリストのいずれかの単位を使用します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

  • "px" — ピクセル

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

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

属性:

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 で導入

参考

| |

トピック