exponenta event banner

класс mlreportgen.ppt.PicicePlaceholder

Пакет: mlreportgen.ppt

Местозаполнитель для слайд-рисунка

Описание

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

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

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

Примечание

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

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Свойства

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • in - дюймы

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

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - пикас

  • pt - точки

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

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

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

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

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

Идентификатор для этого объекта 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'

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'

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

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

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

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

close(ppt);
rptview(ppt);

Совет

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

  • Чтобы увидеть объекты-местозаполнители, создаваемые API PPT для объекта слайда, просмотрите 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