Main Content

mlreportgen.ppt.Picture类

Package:mlreportgen.ppt

Picture to include in presentation

expand all in page

Description

Use an object of themlreportgen.ppt.Pictureclass to include a picture in a presentation.

Themlreportgen.ppt.Pictureclass is ahandleclass.

Class Attributes

ConstructOnLoad
true
HandleCompatible
true

For information on class attributes, seeClass Attributes.

Creation

Description

pictureObj= mlreportgen.ppt.Picture()creates an emptyPictureobject.

example

pictureObj= mlreportgen.ppt.Picture(picturePath)creates aPictureobject that contains the picture specified bypicturePath.

Note

The contents of the specified picture file are copied into the output presentation when the presentation is closed. Do not delete or overwrite the picture file before it is copied into the presentation. If you create a picture file and the correspondingmlreportgen.ppt.Pictureobject in a loop, use a unique file name for the picture file in each loop iteration.

Input Arguments

expand all

Path and name of a picture file, specified as a string scalar or character vector. The PPT API supports the image formats in the table.

Image Format File Extension
Bitmap .bmp
Enhanced Metafile .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

Note

To ensure that your version of PowerPoint®supports the image formats used in your generated presentation, seeFile formats that are supported in PowerPointon the Microsoft®website.

Properties

expand all

Picture file path, specified as a string scalar or character vector.

Internal or external hyperlink target for the picture, specified as an integer, string scalar, or character vector. Use an integer to specify the index of the target slide within the presentation. Use a character vector or string scalar to specify an external URL. When specifying an external URL, use the fully qualified URL. For example, includehttp://.

Picture name, specified as a string scalar or character vector.

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Upper-leftx-coordinate position of the picture, specified as a string scalar or character vector that consists of a number followed by an abbreviation for a unit of measurement. For example, "5in" specifies five inches. Valid abbreviations are:

  • px— pixels (default)

  • cm— centimeters

  • in— inches

  • mm— millimeters

  • pc— picas

  • pt— points

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Upper-lefty-coordinate position of the picture, specified as a string scalar or character vector that consists of a number followed by an abbreviation for a unit of measurement. For example, "5in" specifies five inches. Valid abbreviations are:

  • px— pixels (default)

  • cm— centimeters

  • in— inches

  • mm— millimeters

  • pc— picas

  • pt— points

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Width of the picture, specified as a string scalar or character vector that consists of a number followed by an abbreviation for a unit of measurement. For example, "5in" specifies five inches. Valid abbreviations are:

  • px— pixels (default)

  • cm— centimeters

  • in— inches

  • mm— millimeters

  • pc— picas

  • pt— points

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Height of the picture, specified as a string scalar or character vector that consists of a number followed by an abbreviation for a unit of measurement. For example, "5in" specifies five inches. Valid abbreviations are:

  • px— pixels (default)

  • cm— centimeters

  • in— inches

  • mm— millimeters

  • pc— picas

  • pt— points

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Picture placeholder formatting. This property is ignored.

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Child elements of this PPT API object, specified as a cell array of PPT API objects.

Attributes:

GetAccess
public
SetAccess
private
NonCopyable
true

Parent of this PPT API object, specified as a PPT API object.

Attributes:

GetAccess
public
SetAccess
private
NonCopyable
true

标记这个PPT API对象,指定为一个字符串scalar or character vector. A session-unique tag is generated as part of the creation of this object. The generated tag has the formCLASS:ID, whereCLASSis the object class andIDis the value of theIdproperty of the object.

Specifying your own tag value can help you to identify where issues occur during presentation generation.

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

ID for this PPT API object, specified as a string scalar or character vector. A session-unique ID is generated as part of the object creation. You can specify an ID to replace the generated ID.

Attributes:

GetAccess
public
SetAccess
public
NonCopyable
true

Methods

expand all

Examples

collapse all

Open Live Script

Use anmlreportgen.ppt.Pictureobject to include a picture of an airplane in a presentation.

创建一个presentation.

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

Add a slide with aTitle and Contentlayout to the presentation.

add(ppt,"Title and Content");

创建一个Pictureobject using an image of an airplane. Specify the size of the picture.

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

Replace the content of the slide with the picture.

replace(ppt,"Content",plane);

Close and view the presentation.

close(ppt); rptview(ppt);

Here is the generated slide with the image of the airplane:

Open Live Script

To add an image of a MATLAB figure to a presentation, this example prints the figure to an image file, creates anmlreportgen.ppt.Pictureobject from the file, and adds thePictureobject to a slide in the presentation.

创建一个presentation.

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

Add a slide to the presentation.

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

Add a title to the slide.

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

创建一个MATLAB figure with a surface plot.

fig = figure; surf(peaks);

Print the figure to an image file. Do not delete the image file before generating the presentation.

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

创建一个nmlreportgen.ppt.Pictureobject using the image file.

figPicture = Picture(figSnapshotImage);

Add thePictureobject to the slide.

replace(slide,"Content",figPicture);

Close the presentation.

close(ppt);

Delete the figure and the image file.

delete(fig); delete(figSnapshotImage);

View the presentation.

rptview(ppt);

Here is the generated slide with the image of the figure:

Version History

Introduced in R2015b

expand all

See Also

|

Topics