add

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

プレゼンテーションへのスライドの追加

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

構文

slideObj = add(presentation,slideLayout)

slideObj = add(presentation,slideLayout,slideMaster)

slideObj = add(presentation,slideLayout,otherSlide)

slideObj = add(presentation,slideLayout,slideMaster,otherSlide)

slideObj = add(presentation,slideLayout,index)

slideObj = add(presentation,slideLayout,slideMaster,index)

説明

例

slideObj = add(presentation,slideLayout) は、指定されたスライドレイアウト名を使用し、プレゼンテーションにスライドを追加します。指定されたレイアウトが複数のスライドマスターで出現する場合、PPT API は、テンプレートで最初に出現するレイアウトを使用します。

slideObj = add(presentation,slideLayout,slideMaster) は、指定されたスライドマスターで指定されたスライドレイアウトを使用します。指定されたレイアウトが複数のスライドマスターで出現する場合は、slideMaster 引数を使用します。

slideObj = add(presentation,slideLayout,otherSlide) は、指定されたスライドレイアウトをプレゼンテーションの最初のスライドマスターで使用し、otherSlide 引数で指定されたスライドの直前にスライドを追加します。

例

slideObj = add(presentation,slideLayout,slideMaster,otherSlide) は、指定されたスライドマスターで指定されたスライドレイアウトを使用し、otherSlide スライドの直前にスライドを追加します。

slideObj = add(presentation,slideLayout,index) は、指定されたスライドレイアウトをプレゼンテーションの最初のスライドマスターで使用し、index で指定されたインデックス位置にスライドを追加します。

例

slideObj = add(presentation,slideLayout,slideMaster,index) は、指定されたスライドマスターの指定されたスライドレイアウトを使用し、index で指定されたインデックス位置にスライドを追加します。

例

すべて展開する

プレゼンテーションへのスライドの追加

ライブスクリプトを開く

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

import mlreportgen.ppt.*

myPresentation.pptx という名前のプレゼンテーションを作成して開きます。

ppt = Presentation('myPresentation.pptx');
open(ppt);

最初のスライドを追加してスライドレイアウトを指定しますが、スライドマスターまたは場所は指定しません。

contentSlide = add(ppt,'Title and Content');
replace(contentSlide,'Title','This is the Title of the Slide Content');

Office Theme スライドマスターを使用して別のスライドを追加します。contentSlide で表されるスライドの前に挿入します。

titleSlide = add(ppt,'Title Slide','Office Theme',contentSlide);
replace(titleSlide,'Title','Presentation Title');

Office Theme スライドマスターを使用して空白スライドを追加します。新しいスライドをプレゼンテーションの 2 番目のスライドに設定します。

blankSlide = add(ppt,'Blank','Office Theme',2);

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

close(ppt);
rptview(ppt);

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

入力引数

すべて展開する

`presentation` — スライドを追加するプレゼンテーション
`mlreportgen.ppt.Presentation` オブジェクト

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

`slideLayout` — 追加するスライドのレイアウト
文字ベクトル | string スカラー

追加するスライドのレイアウト。文字ベクトルまたは string スカラーとして指定します。レイアウトはプレゼンテーションテンプレート内になければなりません。

次の方法で、利用可能なレイアウトを確認できます。

getLayoutNames メソッドを使用する。
PowerPoint^® テンプレートで [ホーム] タブの [スライド] セクションにある [レイアウト] をクリックする。

`slideMaster` — スライドレイアウトのスライドマスター
文字ベクトル | string スカラー

指定されたスライドレイアウトのスライドマスター。文字ベクトルまたは string スカラーとして指定します。スライドマスターはプレゼンテーションテンプレート内になければなりません。

利用可能なスライドマスターを確認するには、以下のいずれかの方法を使用します。

getMasterNames メソッドを使用する。
PowerPoint テンプレートで [表示] タブの [マスター表示] セクションにある [スライドマスター] をクリックする。スライドマスターは番号付きスライドです。スライドマスターをポイントし、その名前を確認します。Slide Master という言葉を含めずに名前を指定します。