mlreportgen.ppt.Slide クラス

名前空間: mlreportgen.ppt

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

説明

mlreportgen.ppt.Slide クラスのオブジェクトは、Microsoft^® PowerPoint^® プレゼンテーションのスライドを表します。Slide オブジェクトを作成してプレゼンテーションに追加するには、mlreportgen.ppt.Presentation オブジェクトの add メソッドを使用します。add メソッドは Slide オブジェクトを返します。Slide オブジェクトのメソッドを使用して、スライド コンテンツの追加、検索、および置換を行うことができます。

mlreportgen.ppt.Slide クラスは handle クラスです。

クラス属性

概要	true
ConstructOnLoad	true
HandleCompatible	true

クラス属性の詳細については、クラスの属性を参照してください。

プロパティ

Layout — スライド レイアウト名

文字ベクトル | string スカラー

スライド レイアウト名。文字ベクトルまたは string スカラーとして指定します。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true
Transient	true

データ型: char | string

SlideMaster — スライド マスター名

文字ベクトル | string スカラー

スライド マスター名。文字ベクトルまたは string スカラーとして指定します。このプロパティは読み取り専用です。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true
Transient	true

データ型: char | string

Name — スライド名

文字ベクトル | string スカラー

スライド名。文字ベクトルまたは string スカラーとして指定します。Name プロパティを設定して、プレゼンテーションのスライドを識別できます。mlreportgen.ppt.Presentation クラスの find メソッドを参照してください。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Style — スライドの書式設定

[] | PPT 書式オブジェクトの cell 配列

スライドの書式設定。PPT 書式オブジェクトの cell 配列として指定します。

Style プロパティの既存の値と追加する書式オブジェクトを含む cell 配列を連結して、書式オブジェクトを追加します。以下に例を示します。

import mlreportgen.ppt.*
ppt = Presentation("MyPresentation");
open(ppt);
slide = add(ppt,"Title Only");
slide.Style = [slide.Style {Bold(true),FontColor("red")}];
replace(slide,"Title","My Title is Bold and Red");
close(ppt);
rptview(ppt);

プレゼンテーションの書式設定方法を参照してください。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

Children — このスライドの子

PPT オブジェクトの cell 配列

このスライドの子要素。PPT オブジェクトの cell 配列として指定します。このプロパティは読み取り専用です。

属性:

GetAccess	public
SetAccess	private
NonCopyable	true

Id — オブジェクト識別子

文字ベクトル | string スカラー

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。PPT API は、ドキュメント要素オブジェクトの作成時にセッション固有識別子を生成します。Id には独自の値を指定できます。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

Tag — タグ

文字ベクトル | string スカラー

タグ。文字ベクトルまたは string スカラーとして指定します。PPT API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。この値を使用すると、ドキュメントの生成中に問題が発生した箇所を容易に特定できるようになります。

属性:

GetAccess	public
SetAccess	public
NonCopyable	true

データ型: char | string

メソッド

パブリック メソッド

find	スライドでのコンテンツの検索
add	スライドへのテキスト ボックス、テーブル、または画像の追加
replace	スライド内のテキスト、テーブル、または画像の置換

例

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

プレゼンテーションにスライドを追加するには、mlreportgen.ppt.Presentation オブジェクトの add メソッドを使用します。add メソッドは、mlreportgen.ppt.Slide オブジェクトを返します。Slide オブジェクトの replace メソッドを使用して、コンテンツ プレースホルダーをコンテンツに置き換えます。

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

import mlreportgen.ppt.*

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

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

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

slide = add(ppt,"Title and Table");

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

replace(slide,"Title","magic(4)");

スライド内の Table プレースホルダーをテーブルに置き換えます。

tbl = Table(magic(4));
replace(slide,"Table",tbl);

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

close(ppt);
rptview(ppt);

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

バージョン履歴

R2015a で導入

参考

mlreportgen.ppt.Presentation

トピック

• プログラムによるプレゼンテーションの作成
• スライドの追加
• プレゼンテーション コンテンツの追加と置換