Main Content

replace

クラス: mlreportgen.ppt.Presentation
名前空間: mlreportgen.ppt

プレゼンテーション内のテキスト、テーブル、または画像の置換

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

構文

replace(presentation,contentName,content)

説明

例

replace(presentation,contentName,content) は、プレゼンテーション コンテンツ オブジェクト内の既存のコンテンツを、1 つ以上の段落、1 つのテーブル、または 1 個の画像などの指定されたコンテンツに置き換えます。content 引数で指定したコンテンツのタイプが contentName で識別されるコンテンツ オブジェクトに対して有効でない場合、replace メソッドは効果がありません。

例

すべて展開する

ライブ スクリプトを開く

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

import mlreportgen.ppt.*

プレゼンテーションを作成し、タイトル付きの 2 つのスライドを追加します。

ppt = Presentation('myPresentation.pptx');
open(ppt);
add(ppt,'Title Slide');
add(ppt,'Title and Content');

プレゼンテーション内のすべてのタイトルを My Slide Title というタイトルに置き換えます。

replace(ppt,'Title','My Slide Title');

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

close(ppt);
rptview(ppt);

入力引数

すべて展開する

コンテンツを置き換えるプレゼンテーション。mlreportgen.ppt.Presentation オブジェクトとして指定します。

置き換えるコンテンツを含むオブジェクトの Name プロパティ値。文字ベクトルまたは string スカラーとして指定します。

スライドをプレゼンテーションに追加する場合、add メソッドは、スライド レイアウトに基づいて、スライド上のコンテンツ オブジェクトの Name プロパティを設定します。getLayoutNames を参照してください。Name プロパティ値には次のものがあります。

  • 'Title'

  • 'Content'

  • 'Table'

  • 'Picture'

  • 'Text'

  • 'Vertical Text'

Name プロパティは、カスタム値に設定することもできます。

置換コンテンツ。以下のいずれかの値として指定します。

  • 文字ベクトルまたは string スカラー

  • mlreportgen.ppt.Paragaph オブジェクト

  • 文字ベクトルまたは Paragraph オブジェクト (またはその両方の組み合わせ) の cell 配列

  • string 配列

  • mlreportgen.ppt.Table オブジェクト

  • mlreportgen.ppt.Picture オブジェクト

ヒント

  • 特定のスライドのコンテンツを置き換えるには、mlreportgen.ppt.Slide オブジェクトの replace メソッドを使用します。

バージョン履歴

R2015b で導入

参考

| | |

トピック