replace

コンテンツ プレースホルダーまたはコンテンツの置換

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

構文

replacementContentObj = replace(contentPlaceholder,content)
replace(contentPlaceholder,paragraphs)

説明

replacementContentObj = replace(contentPlaceholder,content) は、ContentPlaceholder オブジェクトのコンテンツを置き換えるか、ContentPlaceholder オブジェクトを置き換えます。content 引数が段落の場合、replace メソッドは、その段落を ContentPlaceholder オブジェクトの子にすることで、ContentPlaceholder のコンテンツを置き換えます。content 引数が画像またはテーブルの場合、replace メソッドは ContentPlaceholder オブジェクトをそれぞれ mlreportgen.ppt.Picture オブジェクトまたは mlreportgen.ppt.Table オブジェクトに置き換えます。

例

replace(contentPlaceholder,paragraphs) は、コンテンツ プレースホルダーのコンテンツを複数の段落に置き換えます。

例

すべて展開する

ライブ スクリプトを開く

プレゼンテーションに 4 つの Title and Content スライドを追加します。最初のスライドのコンテンツ プレースホルダーをテキストに、2 番目のスライドをテーブルに、3 番目のスライドを画像に、4 番目のスライドを複数レベルのリストに置き換えます。

PPT API クラスに長い完全修飾名を使用せずに済むよう、PPT 名前空間をインポートします。

import mlreportgen.ppt.*

プレゼンテーションを作成します。

ppt = Presentation("myContentPlaceholderPresentation.pptx");
open(ppt);

Title and Content レイアウトのスライドを追加します。

slide1 = add(ppt,"Title and Content");

スライド オブジェクトの find メソッドを使用して、Title という名前のプレースホルダー オブジェクトを見つけます。

titlePlaceholderObj1 = find(slide1,"Title");

find メソッドは、mlreportgen.ppt.TextBoxPlaceholder オブジェクトを返します。

プレースホルダーのコンテンツをタイトル テキストに置き換えます。

replace(titlePlaceholderObj1,"Content Replaced with Paragraph");

スライド オブジェクトの find メソッドを使用して、Content という名前のプレースホルダー オブジェクトを見つけます。

contentPlaceholderObj1 = find(slide1,"Content");

find メソッドは、mlreportgen.ppt.ContentPlaceholder オブジェクトを返します。

プレースホルダーのコンテンツを段落に置き換えます。

replace(contentPlaceholderObj1,Paragraph("This is my paragaph"));

Title and Content レイアウトの 2 番目のスライドを追加します。

slide2 = add(ppt,"Title and Content");

タイトルのプレースホルダーをタイトル テキストに置き換えます。

titlePlaceholderObj2 = find(slide2,"Title");
replace(titlePlaceholderObj2,"Content Replaced with Table for Order 2 Magic Square");

コンテンツ プレースホルダーをテーブルに置き換えます。

contentPlaceholderObj2 = find(slide2,"Content");
replace(contentPlaceholderObj2,Table(magic(2)));

Title and Content レイアウトの 3 番目のスライドを追加します。

slide3 = add(ppt,"Title and Content");

タイトルのプレースホルダーをタイトル テキストに置き換えます。

titlePlaceholderObj3 = find(slide3,"Title");
replace(titlePlaceholderObj3,"Content Replaced with Picture of Peppers");

コンテンツ プレースホルダーを画像に置き換えます。

contentPlaceholderObj3 = find(slide3,"Content");
replace(contentPlaceholderObj3,Picture("peppers.png"));

Title and Content レイアウトの 4 番目のスライドを追加します。

slide4 = add(ppt,"Title and Content");

タイトルのプレースホルダーをタイトル テキストに置き換えます。

titlePlaceholderObj4 = find(slide4,"Title");
replace(titlePlaceholderObj4,"Content Replaced with a Multilevel List");

複数レベルのリストのコンテンツを作成します。複数レベルのリストは、サブリストを表す 1 つ以上の cell 配列を含む 1 つの cell 配列として表すことができます。mlreportgen.ppt.Paragraph オブジェクトを使用して、リスト内の項目を書式設定します。

greenTea = Paragraph("Green Tea");
greenTea.FontColor = "green";

multilevelContent = { ...
    "Coffee", ...
    "Tea", ...
    { ...
        "Black Tea", ...
        greenTea, ...
    }, ...
    "Milk", ...
    };

Content プレースホルダーを複数レベルのリストのコンテンツに置き換えます。

contentPlaceholderObj4 = find(slide4,"Content");
replace(contentPlaceholderObj4,multilevelContent);

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

close(ppt);
rptview(ppt);

生成されたスライドは次のようになります。

入力引数

すべて展開する

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

置換項目として使用するコンテンツ。文字ベクトル、string スカラー、または次のオブジェクトのいずれかとして指定します。

置換項目として使用する複数の段落。次の値のいずれかとして指定します。

  • string 配列

  • string スカラー、文字ベクトル、または mlreportgen.ppt.Paragraph オブジェクトの任意の組み合わせから成る cell 配列。内側の配列は、外側の配列からインデントされます。

スライド レイアウトによって、テキストが段落、箇条書き項目、または番号付きリスト項目のいずれとして表示されるかが決まります。

出力引数

すべて展開する

置換コンテンツ。mlreportgen.ppt.Paragraph オブジェクト、mlreportgen.ppt.Picture オブジェクト、または mlreportgen.ppt.Table オブジェクトとして返されます。

バージョン履歴

R2015b で導入

参考

| | | |

トピック