メインコンテンツ

replace

テーブル プレースホルダーからテーブルへの置換

説明

replacementTableObj = replace(tablePlaceholder,table) は、指定されたテーブル プレースホルダーを、指定されたテーブルに置き換え、テーブル オブジェクトを返します。

すべて展開する

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

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

入力引数

すべて展開する

テーブル プレースホルダー。mlreportgen.ppt.TablePlaceholder オブジェクトとして指定します。

テーブル プレースホルダーの置換項目として使用するテーブル。mlreportgen.ppt.Table オブジェクトとして指定します。

出力引数

すべて展開する

置換テーブル。mlreportgen.ppt.Table オブジェクトとして返されます。

バージョン履歴

R2015b で導入