PowerPoint テンプレート要素へのアクセス

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 プログラムでその名前を使用して、プレースホルダーをコンテンツに置き換えることができます。

スライドマスター名の表示と変更

PowerPoint テンプレートは 1 を超えるスライドマスターをもつことができます。スライドマスターは、別のスライドマスターの子スライドレイアウトと同じ名前の子スライドレイアウトをもつことができます。テンプレートに複数のスライドマスターがある場合、PPT API を使用するときに正しいスライドレイアウトを指定できるようにスライドマスターの名前を知っておく必要があります。名前を確認するには、PowerPoint 内で探すか、API を使用します。

マスターの目的を識別するために、マスターの名前を変更できます。スライドマスターの名前は、PowerPoint 内でのみ変更できます。

PowerPoint で、[表示] 、 [スライドマスター] を選択します。
スライドレイアウトペインで、スライドマスターの上にカーソルを置きます。スライドマスターには番号が付いており、ツリー階層の最上位にあります。ツールヒントにその名前が表示されます。この図では、"Office テーマ" が API で使用する名前です。テキスト "スライドマスター" は含めないでください。
マスターの名前を変更する場合は、[スライドマスター] タブの [マスターの編集] セクションで、[名前の変更] をクリックしてプロンプトに従います。

PPT API を使用してスライドマスターの名前を確認するには、getMasterNames メソッドを mlreportgen.ppt.Presentation オブジェクトで使用します。この例では、既定の PPT API PowerPoint テンプレートを使用します。このテンプレートには 1 つのスライドマスターがあります。

import mlreportgen.ppt.*;
slides = Presentation('myPresentation');
getMasterNames(slides);

ans = 

    'Office Theme'

スライドレイアウト名の表示と変更

PPT API を使用してスライドを追加するには、PowerPoint テンプレートのスライドレイアウトの名前を知っておく必要があります。スライドレイアウトの名前を確認するには、PowerPoint 内で探すか、API を使用します。

スライドレイアウトを追加するとき、レイアウトの目的を識別するために、レイアウトの名前を変更できます。スライドレイアウトの名前は、PowerPoint 内でのみ変更できます。

PowerPoint で、[表示] 、 [スライドマスター] を選択します。
スライドレイアウトペインで、スライドマスターの下のスライドレイアウトにカーソルを置きます。ツールヒントにそのスライドレイアウトの名前が表示されます。この図では、"タイトルスライド" が API で使用する名前です。テキスト "レイアウト" は含めないでください。
スライドレイアウトの名前を変更する場合は、[スライドマスター] タブの [マスターの編集] セクションで、[名前の変更] をクリックしてプロンプトに従います。

PPT API を使用してスライドレイアウトの名前を確認するには、Presentation.getLayoutNames メソッドを使用します。レイアウトの名前を取得する前に、スライドマスターの名前を取得する必要があります。PPT API はスライドマスターを cell 配列として返します。この例では、既定の PPT API PowerPoint テンプレートを使用して、テンプレートの最初のマスターからスライドレイアウトを取得します。

import mlreportgen.ppt.*;
slides = Presentation('myPresentation');
masters = getMasterNames(slides);

layouts = getLayoutNames(slides,masters{1});
layouts

Columns 1 through 5

 'Title Slide' 'Title and Vertica…'  'Vertical Title an…'  'Title and Table'  'Title and Picture'

Columns 6 through 11

 'Title and Content'  'Section Header'  'Two Content'  'Comparison'  'Title Only'  'Blank'

Columns 12 through 13

 'Content with Capt…'  'Picture with Capt…'

プレースホルダー名とコンテンツオブジェクト名の表示と変更

PPT API を使用してプレースホルダーをコンテンツに置き換えるには、プレースホルダーの名前を知っておく必要があります。プレースホルダーの名前を確認するには、PowerPoint を使用するか、PPT API を使用します。

プレースホルダーの目的を識別するために、プレースホルダーの名前を変更できます。

PowerPoint で、[表示] 、 [スライドマスター] を選択します。
[ホーム] タブの [編集] セクションで、[選択] 、 [オブジェクトの選択と表示] を選択します。
スライドレイアウトペインで、名前を確認する必要のあるコンテンツプレースホルダーが含まれたレイアウトを選択します。スライドレイアウトで使用されているプレースホルダーの名前が [選択] ペインに表示されます。コンテンツプレースホルダーをクリックし、選択ペインの名前を強調表示します。
次の図は、タイトルとコンテンツスライドレイアウトのコンテンツプレースホルダーの名前が "コンテンツ" であることを示しています。
プレースホルダーの名前を変更する場合は、[選択] ペインで名前をクリックし、新しい名前を入力します。

PowerPoint プレゼンテーションのコンテンツを更新する場合に、そのスライドのコンテンツオブジェクトの名前を確認するには、同様に [オブジェクトの選択と表示] ペインを使用します。例:

テーブルのあるスライドを使用してプレゼンテーションを作成して生成します。

import mlreportgen.ppt.*

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

slide1 = add(ppt,'Blank');
add(slide1,Table(magic(5)));

close(ppt);
rptview(ppt);

PowerPoint で、[選択] ペインを表示します。テーブル名は生成された文字列です。その名前を変更し、新しい名前を PPT API で使用できます。

詳細

プレゼンテーションの書式設定方法