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

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

Настройте шаблон PowerPoint, чтобы содержать содержание презентации, которое вы хотите добавить или заменить.
Создайте объекты содержания API PPT, такие как ParagraphТаблица, и 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);

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

Чтобы добавить или заменить таблицу в представлении, используйте этот подход:

Добавьте таблицу непосредственно в понижение.
Замените заполнителя от размещения понижения с таблицей. Например, добавьте понижение с Title and Content или Title and Table размещение и замена содержимое или табличный заполнитель с таблицей.
Замените таблицу шаблона от представления шаблона с различной таблицей.

Добавьте таблицу в пустой слайд

Создайте mlreportgen.ppt.Table возразите и добавьте его, чтобы скользить.

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx');
open(ppt);
tableSlide = add(ppt,'Blank');
magicTable = Table(magic(5));
magicTable.X = '3in';
magicTable.Y = '5in';
add(tableSlide,magicTable);
close(ppt);

Можно заменить таблицу, которую вы уже добавили в понижение при помощи replace метод. Например:

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx');
open(ppt);
tableSlide = add(ppt,'Blank');
magicTable = Table(magic(5));
add(tableSlide,magicTable);
newTable = Table(magic(4));
replace(magicTable,newTable);
close(ppt);

Замените табличного заполнителя

Можно заменить табличного заполнителя, который прибывает из размещения понижения. Например, добавьте понижение с Title and Table размещение. Табличный заполнитель представлен mlreportgen.ppt.TablePlaceholder объект. Чтобы заменить табличного заполнителя, используйте replace метод TablePlaceholder объект.

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx');
open(ppt);
tableSlide = add(ppt,'Title and Table');
table1 = Table(magic(9));
tblplaceholderObj = find(tableSlide,'Table');
replace(tblplaceholderObj,table1);
close(ppt);

Замените таблицу шаблона

Если вы создаете представление из существующей презентации, таблица из существующей презентации (template table) представлена mlreportgen.ppt.TemplateTable объект. Можно сменить положение, ширину и высоту таблицы шаблона путем установки свойств объекта. Можно также изменить разметку XML таблицы шаблона. Чтобы заменить таблицу шаблона, используйте replace метод TemplateTable объект. Например, предположите, что вы создаете представление из существующей презентации myPresentation это имеет понижение с 'Title and Table' размещение. Следующий код заменяет таблицу шаблона на другую таблицу.

import mlreportgen.ppt.*
ppt = Presentation('myNewPresentation.pptx','myPresentation.pptx');
open(ppt);
slide1 = ppt.Children(1);
templateTableObj = find(slide1,'Table');
replace(templateTableObj,Table(magic(4)));
close(ppt);

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

Чтобы добавить или заменить изображение в представлении, используйте один из этих подходов:

Добавьте изображение непосредственно в понижение.
Замените заполнителя, который прибывает из размещения понижения с изображением. Например, добавьте понижение с Title and Content или Title and Picture размещение и замена довольное или место для рисунка с изображением.
Замените изображение шаблона от представления шаблона с различным изображением.

Добавьте изображение в пустой слайд

Создайте mlreportgen.ppt.Picture возразите и добавьте его, чтобы скользить.

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx');
open(ppt);
pictureSlide = add(ppt,'Blank');
plane = Picture(which('b747.jpg'));
plane.X = '2in';
plane.Y = '2in';
plane.Width = '5in';
plane.Height = '2in';
add(pictureSlide,plane);
close(ppt);

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

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx');
open(ppt);
pictureSlide = add(ppt,'Blank');
plane = Picture(which('b747.jpg'));
plane.X = '2in';
plane.Y = '2in';
add(pictureSlide,plane);
peppers = Picture(which('peppers.png'));
replace(plane,peppers);
close(ppt);

Замените заполнителя

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

import mlreportgen.ppt.*
ppt = Presentation('myPresentation.pptx');
open(ppt);
tableSlide = add(ppt,'Title and Picture');
plane = Picture(which('b747.jpg'));
plane.X = '2in';
plane.Y = '2in';
picplaceholderObj = find(tableSlide,'Picture');
replace(picplaceholderObj,plane);
close(ppt);

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

Замените изображение шаблона

Если вы создаете представление из существующей презентации, изображение из существующей презентации (template picture) представлено mlreportgen.ppt.TemplatePicture объект. Можно сменить положение, ширину и высоту изображения шаблона путем установки свойств объекта. Можно также изменить разметку XML изображения шаблона. Чтобы заменить изображение шаблона, используйте replace метод TemplatePicture объект. Например, предположите, что вы создаете представление из существующей презентации myPresentation это имеет понижение с 'Title and Picture' размещение. Следующий код заменяет изображение шаблона на различное изображение.

import mlreportgen.ppt.*
ppt = Presentation('myNewPresentation.pptx','myPresentation.pptx');
open(ppt);
slide1 = ppt.Children(1);
templateTableObj = find(slide1,'Picture');
replace(templateTableObj,Picture(which('peppers.png')));
close(ppt);

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