メインコンテンツ

mlreportgen.ppt.Picture クラス

R2026b

名前空間: mlreportgen.ppt

プレゼンテーションに含める画像

説明

mlreportgen.ppt.Picture クラスのオブジェクトを使用し、プレゼンテーションに画像を含めます。

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

クラス属性

ConstructOnLoad
true
HandleCompatible
true

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

作成

説明

pictureObj = mlreportgen.ppt.Picture は、空の Picture オブジェクトを作成します。

pictureObj = mlreportgen.ppt.Picture(picturePath) は、picturePath で指定された画像を含む Picture オブジェクトを作成します。

例

メモ

mlreportgen.ppt.Presentation オブジェクトを閉じると、指定された画像ファイルのコンテンツが出力プレゼンテーションにコピーされます。コピー処理が完了する前に、画像ファイルを削除したり上書きしたりしないでください。画像ファイルと対応する mlreportgen.ppt.Picture オブジェクトをループ内に作成する場合は、ループの反復ごとに、画像ファイルに一意のファイル名を使用します。

入力引数

すべて展開する

画像ファイルのパスと名前。文字ベクトルまたは string スカラーとして指定します。PowerPoint (PPT) API は、この表のイメージ形式をサポートしています。

イメージ形式ファイル拡張子
Windows® 拡張メタファイル.emf
Encapsulated PostScript®.eps
Graphics Interchange Format .gif
Joint Photographic Experts Group.jpeg, .jpg
Portable Network Graphics.png
Scalable Vector Graphics.svg
Tagged Image File Format.tif, .tiff

メモ

使用している PowerPoint® のバージョンでサポートされているファイル形式を確認するには、Microsoft® の Web サイトの PowerPoint でサポートされるファイル形式を参照してください。

プロパティ

すべて展開する

画像ファイルのパス。文字ベクトルまたは string スカラーとして指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

画像の内部ハイパーリンクまたは外部ハイパーリンクのターゲット。整数、string スカラー、または文字ベクトルとして指定します。整数を使用して、プレゼンテーション内のターゲット スライドのインデックスを指定します。外部 URL を指定するには、文字ベクトルまたは string スカラーを使用し、完全修飾 URL を指定します。たとえば、http:// を含めます。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: int32 | char | string

画像名。文字ベクトルまたは string スカラーとして指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

左上の x 座標の位置。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

  • "cm" — センチメートル

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

左上の y 座標の位置。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

  • "cm" — センチメートル

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

画像の幅。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

  • "cm" — センチメートル

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

メモ

スライド内の mlreportgen.ppt.ContentPlaceholder オブジェクトを mlreportgen.ppt.Picture オブジェクトに置き換えると、mlreportgen.ppt.Picture オブジェクトの寸法は ContentPlaceholder の寸法によって制限されます。Width プロパティまたは Height プロパティの値が ContentPlaceholder オブジェクトの対応するプロパティの値よりも大きい場合、プレゼンテーションはメディアの縦横比を維持しながら、ContentPlaceholder の寸法内に収まるように Width プロパティと Height プロパティの両方を自動的にサイズ変更します。mlreportgen.ppt.Picture オブジェクトをスライドに直接追加すると、メディアのサイズはスライドのサイズに制限されます。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

画像の高さ。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

  • "cm" — センチメートル

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

メモ

スライド内の mlreportgen.ppt.ContentPlaceholder オブジェクトを mlreportgen.ppt.Picture オブジェクトに置き換えると、mlreportgen.ppt.Picture オブジェクトの寸法は ContentPlaceholder の寸法によって制限されます。Width プロパティまたは Height プロパティの値が ContentPlaceholder オブジェクトの対応するプロパティの値よりも大きい場合、プレゼンテーションはメディアの縦横比を維持しながら、ContentPlaceholder の寸法内に収まるように Width プロパティと Height プロパティの両方を自動的にサイズ変更します。mlreportgen.ppt.Picture オブジェクトをスライドに直接追加すると、メディアのサイズはスライドのサイズに制限されます。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

R2026b 以降

境界線のスタイル。次の表のいずれかの値として指定します。

境界線のスタイル説明
"" または "none"線なし
"solid"実線
"dot"点線
"dash"破線
"largeDash"大きな破線で構成される破線
"dashDot"破線と点が交互に入った線
"largeDashDot"大きな破線と点が交互に入った線
"largeDashDotDot"大きな破線と点のペアが交互に入った線
"systemDash"システム定義の破線パターンを使用した破線
"systemDot"システム定義の点パターンを使用した点線
"systemDashDot"システム定義のパターンを使用した、破線と点が交互に入った線
"systemDashDotDot"システム定義のパターンを使用した、破線と点のペアが交互に入った線

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

R2026b 以降

境界線の色。CSS の色名または 16 進数の RGB 値を含む文字ベクトルまたは string スカラーとして指定します。

形式値
CSS の色名CSS の色名。CSS の色名のリストについては、https://www.w3.org/wiki/CSS/Properties/color/keywords を参照してください。
16 進数の RGB 値"#RRGGBB" 形式の RGB カラー。最初の文字として # を使用し、赤、緑、および青の値に 2 桁の 16 進数を使用します。大文字と小文字のいずれも使用できます。

例: "red" は、CSS の色名を使用して赤色を指定します。

例: "#0000ff" は、16 進数の RGB 値を使用して青色を指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

R2026b 以降

境界線の幅。数値とそれに続く測定単位の略語を含む文字ベクトルまたは string スカラーとして指定します。たとえば、"3pt" は 3 ポイントを指定します。有効な略語を以下に示します。

  • "px" — ピクセル

  • "cm" — センチメートル

  • "in" — インチ

  • "mm" — ミリメートル

  • "pc" — パイカ

  • "pt" — ポイント

単位を省略することで、ピクセルとして指定することもできます。たとえば、"5" は 5 ピクセルを指定します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

境界線の書式設定。mlreportgen.ppt.Border オブジェクトを含む cell 配列として指定します。

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: cell

このオブジェクトの親。PPT API オブジェクトとして指定します。PPT API オブジェクトの親は 1 つでなければなりません。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

このオブジェクトの子要素。PPT API オブジェクトの cell 配列として指定します。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

データ型: cell

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

メソッド

すべて展開する

例

すべて折りたたむ

mlreportgen.ppt.Picture オブジェクトを使用し、飛行機の画像をプレゼンテーションに含めます。

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

import mlreportgen.ppt.*

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

Title and Content レイアウトがあるスライドをプレゼンテーションに追加します。

add(ppt,"Title and Content");

飛行機のイメージを使用して Picture オブジェクトを作成します。画像のサイズを指定します。

plane = Picture(which("b747.jpg"));
plane.Width = "5in";
plane.Height = "2in";

スライドのコンテンツを画像に置き換えます。

replace(ppt,"Content",plane);

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

close(ppt);
rptview(ppt);

飛行機のイメージを使用して生成されたスライドは次のようになります。

Presentation slide containing a photograph of a Boeing 747 airplane in flight

MATLAB® Figure のイメージをプレゼンテーションに追加するために、この例では、Figure をイメージ ファイルに出力し、ファイルから mlreportgen.ppt.Picture オブジェクトを作成し、Picture オブジェクトをプレゼンテーションのスライドに追加します。

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

import mlreportgen.ppt.*

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

プレゼンテーションにスライドを追加します。

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

スライドにタイトルを追加します。

replace(slide,"Title","surf(peaks)");

表面プロットをもつ MATLAB Figure を作成します。

fig = figure;
surf(peaks);

Figure をイメージ ファイルに出力します。プレゼンテーションを作成する前にイメージ ファイルを削除しないでください。

figSnapshotImage = "figSnapshot.png";
print(fig,"-dpng",figSnapshotImage);

イメージ ファイルを使用して mlreportgen.ppt.Picture オブジェクトを作成します。

figPicture = Picture(figSnapshotImage);

Picture オブジェクトをスライドに追加します。

replace(slide,"Content",figPicture);

プレゼンテーションを閉じます。

close(ppt);

Figure とイメージ ファイルを削除します。

delete(fig);
delete(figSnapshotImage);

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

rptview(ppt);

Figure のイメージを使用して生成されたスライドは次のようになります。

Presentation slide titled surf(peaks) with a 3-D surface plot of the peaks function below it.

プレゼンテーション内の画像を置き換えます。

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

import mlreportgen.ppt.*
ppt = Presentation("myPictureReplacePresentation");
slide1 = add(ppt,"Blank");

mlreportgen.ppt.Picture オブジェクトを作成します。

plane = Picture(which("b747.jpg"));
plane.X = "1in";
plane.Y = "1in";
plane.Width = "5in";
plane.Height = "2in";

スライドに画像を追加します。

add(slide1,plane);

2 つ目の画像を作成します。

peppers = Picture(which("peppers.png"));
peppers.X = "1in";
peppers.Y = "1in";
peppers.Width = "3in";
peppers.Height = "3in";

飛行機の画像をピーマンの画像に置き換えます。

replace(plane,peppers);

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

close(ppt);
rptview(ppt);

R2026b 以降

PPT API プレゼンテーション内にある画像の境界線をカスタマイズするには、mlreportgen.ppt.Border オブジェクトで境界線のスタイル、色、幅を指定し、そのオブジェクトを mlreportgen.ppt.Picture オブジェクトの Style プロパティに追加します。

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

import mlreportgen.ppt.*
ppt = Presentation("myPictureBorder.pptx");
open(ppt);

プレゼンテーションにスライドを追加します。

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

画像を作成します。

pic = Picture(which("peppers.png"));

境界線オブジェクトを作成して画像に適用します。

border = Border("solid","red","3pt");
pic.Style = [pic.Style {border}];

スライドにタイトルと画像を追加します。

replace(slide,"Title","Picture with a custom border");
replace(slide,"Picture",pic);

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

close(ppt);
rptview(ppt);

バージョン履歴

R2015b で導入

すべて展開する