mlreportgen.ppt.Picture class

Пакет: mlreportgen.ppt

Изображение, чтобы включать в представление

Описание

Используйте объект mlreportgen.ppt.Picture класс, чтобы включать изображение в представление.

mlreportgen.ppt.Picture классом является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Для получения информации об атрибутах класса см. Атрибуты класса.

Создание

Описание

pictureObj = mlreportgen.ppt.Picture() создает пустой Picture объект.

пример

pictureObj = mlreportgen.ppt.Picture(picturePath) создает Picture объект, который содержит изображение, заданное picturePath.

Примечание

Содержимое заданного файла изображения копируется в выходное представление, когда представление закрывается. Не удаляйте или перезаписывайте файл изображения, прежде чем он будет скопирован в представление. Если вы создаете файл изображения и соответствующий mlreportgen.ppt.Picture объект в цикле, используйте уникальное имя файла для файла изображения в каждой итерации цикла.

Входные параметры

развернуть все

Путь и имя файла изображения в виде строкового скаляра или вектора символов. API PPT поддерживает форматы изображения в таблице.

'imageFormat' Расширение файла
Битовый массив.bmp
Расширенный метафайл.emf
Инкапсулированный формат PostScript®.eps
Формат обмена графическими данными .gif
Формат графических данных JPEG.jpeg, .jpg
Переносимая сетевая графика.png
Масштабируемая векторная графика.svg
Теговый формат графических файлов.tif, .tiff

Примечание

Гарантировать что ваша версия PowerPoint® поддерживает форматы изображения, используемые в вашем сгенерированном представлении, смотрите Форматы файлов, которые поддерживаются в PowerPoint на Microsoft® веб-сайт.

Свойства

развернуть все

Имя изображения в виде строкового скаляра или вектора символов.

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Верхний левый x - положение координат изображения в виде строкового скаляра или вектора символов, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, "5 дюймов" задает пять дюймов. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Верхний левый y - положение координат изображения в виде строкового скаляра или вектора символов, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, "5 дюймов" задает пять дюймов. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Ширина изображения в виде строкового скаляра или вектора символов, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, "5 дюймов" задает пять дюймов. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Высота изображения в виде строкового скаляра или вектора символов, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, "5 дюймов" задает пять дюймов. Допустимые сокращения:

  • px — пиксели (значение по умолчанию)

  • cm 'centimeters'

  • in 'inches'

  • mm — миллиметры

  • pc — цицеро

  • pt 'points'

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Форматирование места для рисунка. Это свойство проигнорировано.

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

Дочерние элементы этого объекта PPT API в виде массива ячеек объектов API PPT.

Атрибуты:

GetAccess
public
SetAccess
private
NonCopyable
true

Родительский элемент этого объекта PPT API в виде объекта PPT API.

Атрибуты:

GetAccess
public
SetAccess
private
NonCopyable
true

Пометьте для этого объекта PPT API в виде строкового скаляра или вектора символов. Уникальный для сеанса тег сгенерирован как часть создания этого объекта. Сгенерированный тег имеет форму CLASS:ID, где CLASS класс объекта и ID значение Id свойство объекта.

Определение вашего собственного значения тега может помочь вам идентифицировать, где проблемы происходят во время генерации представления.

Атрибуты:

GetAccess
public
SetAccess
public
NonCopyable
true

ID для этого объекта PPT API в виде строкового скаляра или вектора символов. Уникальный идентификатор сеанса сгенерирован как часть создания объекта. Можно задать 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);

Вот сгенерированное понижение с изображением самолета:

Чтобы добавить изображение фигуры MATLAB к представлению, этот пример распечатывает фигуру к файлу изображения, создает 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 с объемной поверхностной диаграммой.

fig = figure;
surf(peaks);

Распечатайте фигуру к файлу изображения. Не удаляйте файл изображения прежде, чем сгенерировать представление.

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

Создайте mlreportgen.ppt.Picture объект с помощью файла изображения.

figPicture = Picture(figSnapshotImage);

Добавьте Picture возразите против понижения.

replace(slide,"Content",figPicture);

Закройте представление.

close(ppt);

Удалите фигуру и файл изображения.

delete(fig);
delete(figSnapshotImage);

Просмотрите представление.

rptview(ppt);

Вот сгенерированное понижение с изображением фигуры:

Вопросы совместимости

развернуть все

Поведение изменяется в R2021b

Введенный в R2015b