このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
mlreportgen.ppt.Picture クラス
名前空間: mlreportgen.ppt
プレゼンテーションに含める画像
説明
mlreportgen.ppt.Picture
クラスのオブジェクトを使用し、プレゼンテーションに画像を含めます。
mlreportgen.ppt.Picture
クラスは handle
クラスです。
作成
説明
は、空の pictureObj
= mlreportgen.ppt.Picture()Picture
オブジェクトを作成します。
は、pictureObj
= mlreportgen.ppt.Picture(picturePath
)picturePath
で指定された画像を含む Picture
オブジェクトを作成します。
メモ
指定された画像ファイルのコンテンツは、プレゼンテーションを閉じるときに出力プレゼンテーションにコピーされます。画像ファイルは、プレゼンテーションにコピーされる前に、削除したり上書きしたりしないでください。画像ファイルと対応する mlreportgen.ppt.Picture
オブジェクトをループ内に作成する場合は、ループの反復ごとに、画像ファイルに一意のファイル名を使用します。
入力引数
picturePath
— 画像ファイルのパスと名前
string スカラー | 文字ベクトル
画像ファイルのパスと名前。string スカラーまたは文字ベクトルとして指定します。PPT API は、この表のイメージ形式をサポートしています。
イメージ形式 | ファイル拡張子 |
---|---|
ビットマップ | .bmp |
拡張メタファイル | .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 でサポートされるファイル形式を参照してください。
プロパティ
Path
— 画像ファイルのパス
string スカラー | 文字ベクトル
画像ファイルのパス。string スカラーまたは文字ベクトルとして指定します。
LinkTarget
— 画像のハイパーリンク ターゲット
整数 | string スカラー | 文字ベクトル
画像の内部ハイパーリンクまたは外部ハイパーリンクのターゲット。整数、string スカラー、または文字ベクトルとして指定します。整数を使用して、プレゼンテーション内のターゲット スライドのインデックスを指定します。外部 URL を指定するには、文字ベクトルまたは string スカラーを使用します。外部 URL を指定する場合は、完全修飾 URL を使用してください。たとえば、http://
を含めます。
Name
— 画像名
string スカラー | 文字ベクトル
画像名。string スカラーまたは文字ベクトルとして指定します。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
X
— 画像左上の x 座標の位置
string スカラー | 文字ベクトル
画像左上の x 座標の位置。数値とそれに続く測定単位の略語で構成される string スカラーまたは文字ベクトルとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。
px
— ピクセル (既定)cm
— センチメートルin
— インチmm
— ミリメートルpc
— パイカpt
— ポイント
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
Y
— 画像左上の y 座標の位置
string スカラー | 文字ベクトル
画像左上の y 座標の位置。数値とそれに続く測定単位の略語で構成される string スカラーまたは文字ベクトルとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。
px
— ピクセル (既定)cm
— センチメートルin
— インチmm
— ミリメートルpc
— パイカpt
— ポイント
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
Width
— 画像の幅
string スカラー | 文字ベクトル
画像の幅。数値とそれに続く測定単位の略語で構成される string スカラーまたは文字ベクトルとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。
px
— ピクセル (既定)cm
— センチメートルin
— インチmm
— ミリメートルpc
— パイカpt
— ポイント
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
Height
— 画像の高さ
string スカラー | 文字ベクトル
画像の高さ。数値とそれに続く測定単位の略語で構成される string スカラーまたは文字ベクトルとして指定します。たとえば、"5in" は 5 インチを指定します。有効な略語を以下に示します。
px
— ピクセル (既定)cm
— センチメートルin
— インチmm
— ミリメートルpc
— パイカpt
— ポイント
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
Style
— 画像プレースホルダーの書式設定
無視されます
画像プレースホルダーの書式設定。このプロパティは無視されます。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
Children
— この PPT API オブジェクトの子
PPT API オブジェクトの cell 配列
この PPT API オブジェクトの子要素。PPT API オブジェクトの cell 配列として指定します。
属性:
GetAccess | public |
SetAccess | private |
NonCopyable | true |
Parent
— この PPT API オブジェクトの親
PPT API オブジェクト
この PPT API オブジェクトの親。PPT API オブジェクトとして指定します。
属性:
GetAccess | public |
SetAccess | private |
NonCopyable | true |
Tag
— この PPT API オブジェクトのタグ
string スカラー | 文字ベクトル
この PPT API オブジェクトのタグ。string スカラーまたは文字ベクトルとして指定します。セッション固有タグは、このオブジェクト作成の一環として生成されます。生成されたタグの形式は CLASS:ID
という形式です。ここで、CLASS
はオブジェクト クラスです。ID
はオブジェクトの Id
プロパティの値です。
独自のタグ値を指定すると、プレゼンテーションの生成中に問題が発生した箇所を容易に特定できるようになります。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
Id
— この PPT API オブジェクトの ID
string スカラー | 文字ベクトル
この PPT API オブジェクトの ID。string スカラーまたは文字ベクトルとして指定します。セッション固有 ID は、オブジェクト作成の一環として生成されます。ID を指定して、生成された ID を置き換えることができます。
属性:
GetAccess | public |
SetAccess | public |
NonCopyable | true |
メソッド
例
プレゼンテーションへの画像の追加
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);
飛行機のイメージを使用して生成されたスライドは次のようになります。
Figure スナップショットのプレゼンテーションへの追加
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 のイメージを使用して生成されたスライドは次のようになります。
バージョン履歴
R2015b で導入R2021b: SVG サポート
R2021b 以降、mlreportgen.ppt.Picture
クラスは Scalable Vector Graphics (SVG) イメージに対応しています。SVG イメージが使用している PowerPoint のバージョンでサポートされていることを確認するには、Microsoft の Web サイトの PowerPoint でサポートされるファイル形式を参照してください。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- 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)