プレゼンテーションジェネレーターの作成

PowerPoint^® 用 MATLAB^® API (PPT API) を使用すると、プログラムによって PowerPoint プレゼンテーションを作成および更新できます。たとえば、この MATLAB スクリプトは、タイトルページと、箇条書きリストを使用した 1 つのコンテンツスライドがあるプレゼンテーションを作成します。

import mlreportgen.ppt.*;

ppt = Presentation("mySlides.pptx");
open(ppt);
slide1 = add(ppt,"Title Slide");
replace(slide1,"Title",'My Presentation');
replace(slide1,"Subtitle","Create a Presentation Program");
 
slide2 = add(ppt,"Title and Content");
para = Paragraph("First Content Slide");
para.FontColor = "blue";
replace(slide2,"Title",para);
 
replace(slide2,"Content",["First item","Second item","Third item"]);
 
close(ppt);

MySlides.pptx という名前のプレゼンテーションの作成後、このプレゼンテーションを開くことができます。

rptview(ppt)

生成されたプレゼンテーション MySlides.pptx には、次の 2 つのスライドが含まれます。

First slide with the title "My Presentation" and subtitle "Create a Presentation Program". Second slide with a blue title "First Content Slide" and a bulleted list with the items: "First item", "Second item", and "Third item".

プレゼンテーションコンテンツの更新

PPT API プログラムには一般的に以下のようなコードが含まれます。

mlreportgen.ppt API パッケージをインポートする。PPT API オブジェクトのコンストラクターとメソッドを呼び出すときにパッケージ名を省略するには、このパッケージをインポートします。
```
import mlreportgen.ppt.*;
```
以下を行う Presentation オブジェクトを作成する。
- プレゼンテーションコンテンツの保持
- 生成されるプレゼンテーションの出力場所の指定
- PowerPoint テンプレートの指示
  mySlides.pptx ファイルのプレゼンテーションをテンプレートとして使用し、次のコードでプレゼンテーションを作成し、新しいプレゼンテーションで mySlides.pptx を上書きできます。
```
slidesFile = "mySlides.pptx";
ppt = Presentation(slidesFile, slidesFile);
open(ppt);
```
スライドコンテンツを追加または置換する。
```
slide2 = ppt.Children(2);
contents = find(slide2,"Title");
replace(contents,Paragraph("Modified Content Slide"));

contents = find(slide2,"Content");
datePara = Paragraph("Fourth item: Updated item");

add(contents,datePara);
```
PPT API は、PowerPoint テンプレートのプレースホルダーをプログラム内で定義されたコンテンツに置き換えます。テンプレートでは、対話的にプレースホルダーを追加したり、プログラムで操作するプレースホルダーの名前を変更できます。
プレゼンテーションを閉じる。これにより、プレゼンテーションのコンテンツと書式設定が生成されます。
```
close(ppt);
```

プレゼンテーションを開くコードを含めることができます。

rptview(ppt)

更新後のスライドは次のように表示されます。

Slide two with the title "Modified Content Slide" and four bulleted items: "First item", "Second item", "Third item", and "Fourth item: Updated item"

PPT API プログラムの別の例を確認するには、MATLAB アプリケーションの結果からのプレゼンテーションの生成を参照してください。

PPT API の 2 つの使用方法

以下を行う PPT API プログラムを作成できます。

既存の PowerPoint プレゼンテーションのコンテンツの置き換え、または既存のプレゼンテーションに対するコンテンツの追加
完全な PowerPoint プレゼンテーションの生成

既存のプレゼンテーションへのコンテンツの追加

コンテンツを変更するたびにプレゼンテーションを手動で更新することなく、既存のプレゼンテーションにコンテンツを追加したりそのコンテンツを更新したりするには、PPT API を使用します。この方法は、既存のプレゼンテーションの大部分のコンテンツと書式設定を使用する場合に便利です。

PPT API と MATLAB 関数を使用することで、MATLAB コードと Simulink^® モデルからプレゼンテーションのコンテンツを生成できる。
プレゼンテーションファイルを上書きしてプレゼンテーションを更新するか、異なるプレゼンテーション名を使用して別のバージョンのプレゼンテーションを作成できる。

完全なプレゼンテーションの作成

同じコンテンツを使用している場合に複数の PowerPoint テンプレートを使用して完全なプレゼンテーションを作成するには、PPT API を使用します。

PPT API アプリケーションと PowerPoint テンプレート

PPT API は、プレゼンテーションを生成するためのテンプレートとして、PowerPoint プレゼンテーションを使用します。テンプレートを使用すると、プレゼンテーションのスライドの固定コンテンツおよび既定のレイアウトと外観を指定できます。MATLAB プログラムは、PPT API を使用して特定のスライドの既定のレイアウトと書式をオーバーライドできます。

このテンプレートは空のプレゼンテーションまたはスライドを含むプレゼンテーションです。PPT API プレゼンテーションのテンプレートとして以下を使用できます。

既定の PPT API PowerPoint テンプレート
既定の PPT API PowerPoint テンプレートのカスタマイズしたコピー
更新するコンテンツのある既存の PowerPoint プレゼンテーション
PowerPoint で対話的に作成または更新する PowerPoint テンプレート

PowerPoint プレゼンテーションテンプレートの設定を参照してください。

テンプレート要素

PowerPoint テンプレートには、プレゼンテーションを生成するために PPT API で使用するいくつかの要素が含まれています。テンプレートで定義された書式設定をカスタマイズするには、次の 1 つ以上のテンプレート要素を変更します。

PowerPoint テンプレート要素	目的
スライドマスター	スライドマスターの書式設定をプレゼンテーションにグローバルに適用します。一連のスライドレイアウトに共通のレイアウトと書式を指定します。
スライドレイアウト	スライドマスターのレイアウトのバリアントを指定します。
テーブルスタイル	テーブルの既定の外観を指定します。PowerPoint では、標準のテーブルスタイルが定義されています。これらのスタイルは変更できませんが、PPT API を使用することで、作成するテーブルにこれらのスタイルを適用し、特定のテーブルのスタイルをオーバーライドできます。
プレースホルダー	テキスト、リスト、図、テーブルなどのコンテンツに置き換え可能なスライドレイアウトの領域を指定します。すべてのプレースホルダーには名前があります。PowerPoint を対話的に使用して、名前をプレースホルダーに割り当てることができます。その後、PPT プログラムでその名前を使用して、プレースホルダーをコンテンツに置き換えることができます。