exponenta event banner

класс mlreportgen.ppt.TemplatePicture

Пакет: mlreportgen.ppt

Изображение из слайда презентации шаблона

Описание

Объекты mlreportgen.ppt.TemplatePicture представляют изображения шаблонов. Рисунок шаблона - это рисунок, полученный на слайде в презентации шаблона. Настройка рисунка шаблона путем изменения свойств связанного mlreportgen.ppt.TemplatePicture объект. Замена рисунка шаблона другим изображением с помощью replace способ mlreportgen.ppt.TemplatePicture объект.

mlreportgen.ppt.TemplatePicture класс является handle класс.

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

HandleCompatible
true
ConstructOnLoad
true

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Создание

Вы не создаете mlreportgen.ppt.TemplatePicture явно. При создании презентации из существующей презентации API MATLAB ® для PowerPoint ® (PPT API) создает mlreportgen.ppt.TemplatePicture объект для каждого изображения, полученного из слайда в презентации шаблона.

Вы можете получить доступ к mlreportgen.ppt.TemplatePicture объект для рисунка шаблона с помощью:

  • find способ mlreportgen.ppt.Presentation объект.

  • find способ mlreportgen.ppt.Slide объект, соответствующий слайду, содержащему рисунок шаблона.

  • Children имущества mlreportgen.ppt.Slide объект, соответствующий слайду, содержащему рисунок шаблона.

Примечание

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

Свойства

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

XML-разметка рисунка шаблона, заданная как символьный вектор. Можно изменить рисунок шаблона, изменив разметку XML. Измените разметку XML для настроек, для которых нет свойства. Обновленная разметка записывается в созданную презентацию. При обновлении других свойств, например X, Y, Width, или Heightсоответствующие атрибуты в разметке XML обновляются перед записью разметки в сгенерированное представление.

Имя рисунка, указанное как вектор символа или скаляр строки.

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

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

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

Когда PPT API создает объект mlreportgen.ppt.TemplatePicture, это значение свойства задается в английских метрических единицах (EMU). При установке этого свойства необходимо использовать одну из единиц измерения в предыдущем списке.

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

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

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

Когда PPT API создает mlreportgen.ppt.TemplatePicture это значение свойства задается в английских метрических единицах (EMU). При установке этого свойства необходимо использовать одну из единиц измерения в предыдущем списке.

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

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

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

Когда PPT API создает mlreportgen.ppt.TemplatePicture это значение свойства задается в английских метрических единицах (EMU). При установке этого свойства необходимо использовать одну из единиц измерения в предыдущем списке.

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

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

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

Когда PPT API создает mlreportgen.ppt.TemplatePicture это значение свойства задается в английских метрических единицах (EMU). При установке этого свойства необходимо использовать одну из единиц измерения в предыдущем списке.

Это свойство игнорируется.

Это свойство, доступное только для чтения, пустое.

Родительский объект этого объекта, указанный как PPT-объект. Это свойство доступно только для чтения.

Идентификатор для этого объекта PPT API, указанный как вектор символов или строковый скаляр. Уникальный идентификатор сеанса генерируется как часть создания объекта. Можно указать идентификатор для замены созданного идентификатора.

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

Указание собственного значения тега может помочь определить, где возникла проблема во время создания презентации.

Методы

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

Примеры

свернуть все

Создание презентации, MyPicturePresentation, которая затем используется в качестве шаблона презентации для другой презентации. MyPicturePresentation имеет два слайда, и каждый слайд имеет одну картинку.

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

slide1 = add(ppt,"Title and Picture");
replace(slide1,"Title","Plane");
replace(slide1,"Picture",Picture("b747.jpg"));

slide2 = add(ppt,"Title and Picture");
replace(slide2,"Title","Street");
replace(slide2,"Picture",Picture("street1.jpg"));

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Создание презентации, MyNewPicturePresentation, от MyPicturePresentation. MyPicturePresentation является шаблонным представлением для MyNewPicturePresentation.

ppt = Presentation("MyNewPicturePresentation","MyPicturePresentation");
open(ppt);

Поиск рисунков шаблона с помощью find метод объектов слайда. Потому что изображения получены из презентации шаблона, find возвращает изображения как mlreportgen.ppt.TemplatePicture объекты.

slide1 = ppt.Children(1);
slide2 = ppt.Children(2);
templatePictureObj1 = find(slide1,"Picture")
templatePictureObj1 = 
  TemplatePicture with properties:

    XMLMarkup: '<p:pic><p:nvPicPr><p:cNvPr id="8" name="Picture"/><p:cNvPicPr><a:picLocks noChangeAspect="1" noGrp="1"/></p:cNvPicPr><p:nvPr><p:ph idx="13" sz="quarter" type="pic"/></p:nvPr></p:nvPicPr><p:blipFill><a:blip r:embed="rId2"/><a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr/></p:pic>'
         Name: 'Picture'
            X: []
            Y: []
        Width: []
       Height: []
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplatePicture:435:246'
           Id: '435:246'

templatePictureObj2 = find(slide2,"Picture")
templatePictureObj2 = 
  TemplatePicture with properties:

    XMLMarkup: '<p:pic><p:nvPicPr><p:cNvPr id="8" name="Picture"/><p:cNvPicPr><a:picLocks noChangeAspect="1" noGrp="1"/></p:cNvPicPr><p:nvPr><p:ph idx="13" sz="quarter" type="pic"/></p:nvPr></p:nvPicPr><p:blipFill><a:blip r:embed="rId2"/><a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr/></p:pic>'
         Name: 'Picture'
            X: []
            Y: []
        Width: []
       Height: []
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplatePicture:439:248'
           Id: '439:248'

Измените размер рисунка на первом слайде.

templatePictureObj1.Width = "4in";
templatePictureObj1.Height = "3in";

Замените изображение на втором слайде изображением другой улицы.

replace(templatePictureObj2,Picture("street2.jpg"));

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);
Представлен в R2019b