mlreportgen.ppt.TablePlaceholder クラス
名前空間: mlreportgen.ppt
スライド テーブルのプレースホルダー
説明
mlreportgen.ppt.TablePlaceholder クラスのオブジェクトは、スライド内のテーブル プレースホルダーを表します。
プレゼンテーションにスライドを追加し、そのスライド レイアウトがテーブル プレースホルダーをもつ場合に、PPT API は TablePlaceholder オブジェクトを作成します。既定の PPT API の Title and Table レイアウトには、テーブル プレースホルダーがあります。
TablePlaceholder オブジェクトを検索するには、テーブル プレースホルダーを含むスライドの find メソッドを使用します。テーブル プレースホルダーをテーブルに置き換えるには、TablePlaceholder オブジェクトの replace メソッドを使用します。replace メソッドは、TablePlaceholder オブジェクトを mlreportgen.ppt.Table オブジェクトに置き換えます。
TablePlaceholder オブジェクトのプロパティを使用して、置き換えるテーブルの位置またはサイズを指定します。ただし、テキストの書式設定のプロパティは無視されます。TablePlaceholder オブジェクトを置き換えるために使用するテーブルに書式設定を適用するには、Table オブジェクトのプロパティを使用します。
mlreportgen.ppt.TablePlaceholder クラスは handle クラスです。
プロパティ
メソッド
例
Title and Table スライドをプレゼンテーションに追加し、タイトルとテーブルのプレースホルダーを独自のタイトルとテーブルに置き換えます。
PPT API クラスに長い完全修飾名を使用せずに済むよう、PPT 名前空間をインポートします。
import mlreportgen.ppt.*プレゼンテーションを作成します。
ppt = Presentation("myTablePlaceholderPresentation.pptx");
open(ppt);Title and Table レイアウトのスライドを追加します。
slide = add(ppt,"Title and Table");スライド オブジェクトの find メソッドを使用して、Title という名前のプレースホルダー オブジェクトを見つけます。
titlePlaceholderObj = find(slide,"Title")titlePlaceholderObj =
TextBoxPlaceholder with properties:
Bold: []
Font: []
ComplexScriptFont: []
FontColor: []
FontSize: []
Italic: []
Strike: []
Subscript: []
Superscript: []
Underline: []
BackgroundColor: []
VAlign: []
Name: 'Title'
X: []
Y: []
Width: []
Height: []
Style: []
Children: []
Parent: [1×1 mlreportgen.ppt.Slide]
Tag: 'ppt.TextBoxPlaceholder:555:529'
Id: '555:529'
find メソッドは、mlreportgen.ppt.TextBoxPlaceholder オブジェクトを返します。
プレースホルダーのコンテンツをタイトル テキストに置き換えます。
replace(titlePlaceholderObj,"Fourth-Order Magic Square");スライド オブジェクトの find メソッドを使用して、Table という名前のプレースホルダー オブジェクトを見つけます。
tablePlaceholderObj = find(slide,"Table")tablePlaceholderObj =
TablePlaceholder with properties:
Bold: []
Font: []
ComplexScriptFont: []
FontColor: []
FontSize: []
Italic: []
Strike: []
Subscript: []
Superscript: []
Underline: []
BackgroundColor: []
VAlign: []
Name: 'Table'
X: []
Y: []
Width: []
Height: []
Style: []
Children: []
Parent: [1×1 mlreportgen.ppt.Slide]
Tag: 'ppt.TablePlaceholder:556:530'
Id: '556:530'
find メソッドは、mlreportgen.ppt.TablePlaceholder オブジェクトを返します。
テーブル プレースホルダーを 4 次魔方陣のテーブルに置き換えます。
replace(tablePlaceholderObj,Table(magic(4)));
プレゼンテーションを閉じて表示します。
close(ppt); rptview(ppt);
生成されたプレゼンテーションのスライドは次のようになります。
ヒント
プレゼンテーション内のテーブル プレースホルダーをテーブルに置き換えて、その後にそのプレゼンテーションを新規プレゼンテーションのテンプレートとして使用する場合は、PPT API が新規プレゼンテーション内のテーブルに対して
mlreportgen.ppt.TemplateTableオブジェクトを作成します。テーブルの追加または置換を参照してください。PPT API がスライド オブジェクト用に作成するプレースホルダー オブジェクトを表示するには、スライドの
Childrenプロパティを表示します。たとえば、Title and Tableスライドをプレゼンテーションに追加すると、Childrenプロパティは、mlreportgen.ppt.TextBoxPlaceholderオブジェクトとmlreportgen.ppt.TablePlaceholderオブジェクトを含む配列になります。ppt = mlreportgen.ppt.Presentation("test.pptx"); open(ppt); slide = add(ppt,"Title and Table"); slide.Children(1)
ans = TextBoxPlaceholder with properties: Bold: [] Font: [] ComplexScriptFont: [] FontColor: [] FontSize: [] Italic: [] Strike: [] Subscript: [] Superscript: [] Underline: [] BackgroundColor: [] VAlign: [] Name: 'Title' X: [] Y: [] Width: [] Height: [] Style: [] Children: [] Parent: [1×1 mlreportgen.ppt.Slide] Tag: 'ppt.TextBoxPlaceholder:6:7' Id: '6:7'slide.Children(2)
ans = TablePlaceholder with properties: Bold: [] Font: [] ComplexScriptFont: [] FontColor: [] FontSize: [] Italic: [] Strike: [] Subscript: [] Superscript: [] Underline: [] BackgroundColor: [] VAlign: [] Name: 'Table' X: [] Y: [] Width: [] Height: [] Style: [] Children: [] Parent: [1×1 mlreportgen.ppt.Slide] Tag: 'ppt.TablePlaceholder:7:8' Id: '7:8'
バージョン履歴
R2015b で導入
