mlreportgen.ppt.Picture クラス
R2026b名前空間: mlreportgen.ppt
プレゼンテーションに含める画像
説明
mlreportgen.ppt.Picture クラスのオブジェクトを使用し、プレゼンテーションに画像を含めます。
mlreportgen.ppt.Picture クラスは handle クラスです。
作成
説明
は、空の pictureObj = mlreportgen.ppt.PicturePicture オブジェクトを作成します。
は、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);
飛行機のイメージを使用して生成されたスライドは次のようになります。

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 のイメージを使用して生成されたスライドは次のようになります。

プレゼンテーション内の画像を置き換えます。
プレゼンテーションを作成します。
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 で導入プレゼンテーション内の画像に境界線を追加するには、Border プロパティ、BorderColor プロパティ、BorderWidth プロパティ、および Style プロパティを使用します。
Report Generator で、出力イメージ形式の BMP (ビットマップ) がサポートされなくなりました。これは、レポート エクスプローラーと API (レポート、DOM、PPT) の両方で、スナップショット、ファイルからのイメージ、透かしに影響します。詳細については、print を参照してください。
mlreportgen.ppt.Picture クラスは Scalable Vector Graphics (SVG) イメージをサポートしています。使用している PowerPoint のバージョンで SVG イメージがサポートされていることを確認するには、Microsoft の Web サイトの PowerPoint でサポートされるファイル形式を参照してください。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Web サイトの選択
Web サイトを選択すると、翻訳されたコンテンツにアクセスし、地域のイベントやサービスを確認できます。現在の位置情報に基づき、次のサイトの選択を推奨します:
また、以下のリストから Web サイトを選択することもできます。
最適なサイトパフォーマンスの取得方法
中国のサイト (中国語または英語) を選択することで、最適なサイトパフォーマンスが得られます。その他の国の MathWorks のサイトは、お客様の地域からのアクセスが最適化されていません。
南北アメリカ
- América Latina (Español)
- Canada (English)
- United States (English)
ヨーロッパ
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)