mlreportgen.ppt.PicturePlaceholder class

Пакет: mlreportgen.ppt

Заполнитель для слайд-изображения

Описание

Объект mlreportgen.ppt.PicturePlaceholder класс представляет заполнитель рисунка на слайде.

PPT API создает PicturePlaceholder объект, когда вы добавляете слайд к презентации и размещению слайда, который имеет заполнитель изображения. В PPT API по умолчанию Title and Picture и Picture with Caption размещения имеют заполнители изображений.

Как найти PicturePlaceholder объект, используйте find метод слайда, который содержит заполнитель изображения. Чтобы заменить заполнитель изображения изображением, используйте replace метод PicturePlaceholder объект. The replace метод заменяет PicturePlaceholder объект со mlreportgen.ppt.Picture объект.

Примечание

Microsoft® PowerPoint® настраивает размер изображения в соответствии с местозаполнителем изображения. Используйте слайд с заполнителем рисунка, когда необходимо, чтобы положение и размер заполнителя были фиксированы на слайде. Можно задать местоположение и размер заполнителя рисунка, изменив размещение слайда в PowerPoint. См. раздел Настройка шаблона презентации PowerPoint. Если положение заполнителя и размер не должны быть фиксированы, можно использовать слайд, размещение которого имеет заполнитель содержимого. PowerPoint настраивает размер заполнителя содержимого так, чтобы он соответствовал размеру изображения. См. mlreportgen.ppt.ContentPlaceholder.

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

расширить все

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

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

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

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

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

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

Методы

расширить все

Примеры

свернуть все

Добавление Title and Picture слайд к презентации, а затем замените заполнители заголовка и рисунка на ваш собственный заголовок и изображение.

Импортируйте пакет PPT, чтобы не использовать длинные, полные имена для классов PPT API.

import mlreportgen.ppt.*

Создайте презентацию.

ppt = Presentation("myPicturePlaceholderPresentation.pptx");
open(ppt);

Добавьте слайд с Title and Picture размещение.

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

Используйте find метод объекта слайда для поиска объекта-заполнителя с именем Title.

titlePlaceholderObj = find(slide,"Title")
titlePlaceholderObj = 
  TextBoxPlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Title'
                    X: []
                    Y: []
                Width: []
               Height: []
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.TextBoxPlaceholder:6:9'
                   Id: '6:9'

The find метод возвращает mlreportgen.ppt.TextBoxPlaceholder объект.

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

replace(titlePlaceholderObj,"Airplane");

Используйте find метод объекта слайда для поиска объекта-заполнителя с именем Picture.

picturePlaceholderObj = find(slide,"Picture")
picturePlaceholderObj = 
  PicturePlaceholder with properties:

                 Bold: []
                 Font: []
    ComplexScriptFont: []
            FontColor: []
             FontSize: []
               Italic: []
               Strike: []
            Subscript: []
          Superscript: []
            Underline: []
      BackgroundColor: []
               VAlign: []
                 Name: 'Picture'
                    X: []
                    Y: []
                Width: []
               Height: []
                Style: []
             Children: []
               Parent: [1×1 mlreportgen.ppt.Slide]
                  Tag: 'ppt.PicturePlaceholder:7:10'
                   Id: '7:10'

The find метод возвращает mlreportgen.ppt.PicturePlaceholder объект.

Замените заполнитель рисунка изображением.

replace(picturePlaceholderObj,Picture("b747.jpg"));

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

close(ppt);
rptview(ppt);

Совет

  • Когда вы заменяете заполнитель изображения в презентации изображением, а затем используете презентацию как шаблон для новой презентации, PPT API создает mlreportgen.ppt.TemplatePicture объект для изображения в новой презентации. См. раздел Добавление или замена изображения.

  • Чтобы увидеть объекты-заполнители, созданные PPT API для объекта слайда, просмотрите Children свойство слайда. Для примера, когда вы добавляете Title and Picture слайд к презентации, Children свойство является массивом, который содержит mlreportgen.ppt.TextBoxPlaceholder объект и mlreportgen.ppt.PicturePlaceholder объект.

    ppt = mlreportgen.ppt.Presentation("test.pptx");
    open(ppt);
    slide = add(ppt,"Title and Picture");
    slide.Children(1)
    
    ans = 
    
      TextBoxPlaceholder with properties:
    
                     Bold: []
                     Font: []
        ComplexScriptFont: []
                FontColor: []
                 FontSize: []
                   Italic: []
                   Strike: []
                Subscript: []
              Superscript: []
                Underline: []
          BackgroundColor: []
                   VAlign: []
                     Name: 'Title'
                        X: []
                        Y: []
                    Width: []
                   Height: []
                    Style: []
                 Children: []
                   Parent: [1×1 mlreportgen.ppt.Slide]
                      Tag: 'ppt.TextBoxPlaceholder:6:9'
                       Id: '6:9'

    slide.Children(2)
    
    ans = 
    
      PicturePlaceholder with properties:
    
                     Bold: []
                     Font: []
        ComplexScriptFont: []
                FontColor: []
                 FontSize: []
                   Italic: []
                   Strike: []
                Subscript: []
              Superscript: []
                Underline: []
          BackgroundColor: []
                   VAlign: []
                     Name: 'Picture'
                        X: []
                        Y: []
                    Width: []
                   Height: []
                    Style: []
                 Children: []
                   Parent: [1×1 mlreportgen.ppt.Slide]
                      Tag: 'ppt.PicturePlaceholder:7:10'
                       Id: '7:10'
Введенный в R2015b