Добавьте и замените содержание презентации

Чтобы использовать API PPT, чтобы добавить, или заменить, удовлетворите в представлении PowerPoint^®:

Настройте шаблон PowerPoint, чтобы содержать содержание презентации, которое вы хотите добавить или заменить.
Создайте объекты содержания API PPT, такие как Paragraph, Table и объекты Picture.
Используйте объекты содержания API PPT, чтобы добавить или заменить содержание презентации.

Можно добавить и заменить содержимое несколькими способами. Например, вы можете:

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

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

Настройте шаблон

Можно заменить или добавить содержимое в существующую презентацию PowerPoint, не изменяя шаблон. Однако использование API PPT требует знания шаблона и объектов понижения, включая:

Имена мастера слайдов
Двигайте имена размещения
Двигайте имена объекта местозаполнителя и объекта содержания
Имена стиля таблицы

Можно использовать использование PowerPoint, чтобы добавить заполнителей в представление и затем использовать API PPT, чтобы заменить заполнителя на содержимое. Чтобы заменить определенный объект содержания в представлении, можно использовать PowerPoint, чтобы дать уникальное имя объекту содержания. Затем используйте то имя с API PPT.

Для получения дополнительной информации об использовании шаблонов PowerPoint с программой API PPT см.:

Содержимое замены

Можно заменить содержимое путем определения имени объекта содержания в методе replace с объектом Slide. Например, в шаблоне PPT API по умолчанию, размещение Титульного слайда имеет объект содержания под названием Title.

titleSlide = add(slides,'Title Slide');

replace(titleSlide,'Title','This Is My Title');

Чтобы заменить содержание презентации, можно использовать метод find с объектом Presentation или Slide. Метод find ищет объекты содержания, значение свойства Name которых совпадает с поисковым значением, которое вы задаете. Затем можно использовать индекс возвращенного элемента, который вы хотите обновить.

slides = Presentation('myPresentation');
titleSlide = add(slides,'Title Slide');

contents = find(slides,'Title');
replace(contents(1),'This Is My Title');

Добавьте и замените текст

Можно использовать эти подходы, чтобы добавить или заменить текст в представлении.

Текстовый метод спецификации	Сопоставленные объекты API PPT
Задайте текст как часть создания этих объектов.	`Text` `Paragraph` `ExternalLInk`
Добавьте текст к абзацу или внешней ссылке.	Добавьте текст к этим объектам API PPT: `Paragraph` `TableEntry` `ExternalLink`
Замените объект `Paragraph` в представлении или понижении.	Задайте вектор символов, объект `Paragraph`, или массив ячеек из символьных векторов или объекты `Paragraph` или комбинацию обоих видов объектов, для метода `replace` с этими объектами: `Presentation` `Slide`
Добавьте к или замените текст в объекте местозаполнителя.	Добавьте в объект `ContentPlaceholder` вектор символов, объект `Paragraph`, или с массивом ячеек из символьных векторов или объектами `Paragraph` или комбинацией обоих. Замените объект `ContentPlaceholder` на объект `Paragraph`. Добавьте в объект `TextBoxPlaceholder` вектор символов, объект `Paragraph`, или с массивом ячеек из символьных векторов или объектами `Paragraph` или комбинацией обоих. Замените объект `TextBoxPlaceholder` на объект `Paragraph`. Смотрите добавляют и заменяют текст в заполнителях.
Добавьте к, или замена, текстовое поле.	Добавьте к или замените объект `TextBox` на вектор символов, объект `Paragraph`, или на массив ячеек из символьных векторов или объекты `Paragraph` или комбинацию обоих. Смотрите добавляют или заменяют текст в текстовом поле.

Добавьте и замените текст в заполнителях

Можно добавить или заменить текст в ContentPlaceholder и TextBoxPlaceholder, задав:

Вектор символов
Объект Paragraph
Массив ячеек из символьных векторов или Paragraph возражают или комбинация объектов Paragraph и векторов символов. Внутренний массив ячеек указывает, что внутренний список (расположил элементы с отступом).

Размещение понижения задает, появляется ли текст как абзацы, маркированный список или пронумерованный список.

import mlreportgen.ppt.*
 
name1 = 'before';
slides = Presentation(name1);
add(slides,'Comparison');
replace(slides, 'Left Content', 'dummy content');
replace(slides, 'Right Content', 'dummy content');
close(slides);
 
name2 = 'after';
slides = Presentation(name2, name1);
 
lefts = find(slides, 'Left Content');
rights = find(slides, 'Right Content');
 
para = replace(lefts(1), 'Left item in the list' );
para.Italic = true;
para.FontColor = 'green';
 
replace(rights(1), { ...
    'Right List item', ...
        { 'Inner right list item', 'Other inner right list item' }...
    'Right List item', ...
    });
 
close(slides);
 
if ispc
    winopen(slides.OutputPath);
end

Добавьте или замените текст в текстовом поле

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

Создайте объект TextBox. Задайте местоположение и ширину текстового поля.
Добавьте текст при помощи метода add с объектом TextBox.
Добавьте объект TextBox в представление с помощью метода add с объектом Presentation или метода add с объектом Slide.

Например:

import mlreportgen.ppt.*;
slides = Presentation('myPresentation.pptx');
titleSlide = add(slides,'Title Slide');

tb = TextBox();
tb.X = '2in';
tb.Y = '2in';
tb.Width = '5in';
add(tb,'Text for text box');

add(titleSlide,tb);
close(slides);

Добавьте или замените таблицу

Чтобы добавить или заменить таблицу в представлении, сначала создайте объект Table. Можно добавить таблицу при помощи метода add с объектом Slide.

import mlreportgen.ppt.*;
slides = Presentation('myPresentation.pptx');
tableSlide = add(slides,'Blank');

magicTable = Table(magic(5));
magicTable.X = '3in';
magicTable.Y = '5in';

add(tableSlide,magicTable);

close(slides);

Чтобы заменить содержимое в таблице, замените целую таблицу. Чтобы заменить объект Table, используйте метод replace с объектом Table и задайте другой объект Table. Чтобы заменить таблицу в заполнителе содержимого понижения, используйте метод replace с объектом Slide и задайте объект Table.

slides = Presentation('myPresentation');
tableSlide = add(slides,'Title and Table');

table1 = Table(magic(9));
contents = find(tableSlide,'Table');
replace(contents(1),table1);

close(slides);

Добавьте или замените изображение

Можно добавить изображение при помощи метода add или метода replace с объектом Slide.

import mlreportgen.ppt.*;
slides = Presentation('myPresentation.pptx');
pictureSlide = add(slides,'Blank');

plane = Picture(which('b747.jpg'));
plane.X = '2in';
plane.Y = '2in';
plane.Width = '5in';
plane.Height = '2in';

add(pictureSlide,plane);

close(slides);

Можно использовать метод replace с объектом Picture или PicturePlaceholder. Например, шаблон по умолчанию имеет размещение понижения Заголовка и Изображения, которое имеет место для рисунка под названием Picture.

import mlreportgen.ppt.*;
slides = Presentation('myPresentation');
pictSlide = add(slides,'Title and Picture');

plane2 = Picture(which('b747.jpg'));
contents = find(pictSlide,'Picture');
replace(contents(1),plane2);

close(slides);

PowerPoint настраивает размерности изображения, чтобы поместиться в место для рисунка. Если размерности места для рисунка больше, чем размерности объекта Picture, изображение простирается пропорционально. Если размерности меньше, изображение сосредоточено.

Документация