Чтобы использовать 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(ppt,'Title Slide'); replace(titleSlide,'Title','This Is My Title');
Чтобы заменить содержание презентации, можно использовать find метод с Presentation или Slide объект. find метод ищет объекты содержания чей Name значение свойства совпадает с поисковым значением, которое вы задаете. Затем можно использовать индекс возвращенного элемента, который вы хотите обновить.
ppt = Presentation('myPresentation'); titleSlide = add(ppt,'Title Slide'); contents = find(ppt,'Title'); replace(contents(1),'This Is My Title');
Можно использовать эти подходы, чтобы добавить или заменить текст в представлении.
| Текстовый метод спецификации | Сопоставленные объекты API PPT |
|---|---|
Задайте текст как часть создания этих объектов. |
|
Добавьте текст к абзацу. | Добавьте текст к этим объектам API PPT:
|
Замените | Задайте вектор символов,
|
Добавьте к или замените текст в объекте местозаполнителя. |
|
Добавьте к, или замена, текстовое поле. | Добавьте к или замените |
Можно добавить или заменить текст в ContentPlaceholder и TextBoxPlaceholder, определение:
Вектор символов
Paragraph объект
Массив ячеек из символьных векторов или Paragraph объекты или комбинация векторов символов и Paragraph объекты. Внутренний массив ячеек указывает, что внутренний список (расположил элементы с отступом).
Размещение понижения задает, появляется ли текст как абзацы, маркированный список или пронумерованный список.
import mlreportgen.ppt.* name1 = 'before'; ppt = Presentation(name1); open(ppt); add(ppt,'Comparison'); replace(ppt, 'Left Content', 'dummy content'); replace(ppt, 'Right Content', 'dummy content'); close(ppt); name2 = 'after'; slides = Presentation(name2, name1); lefts = find(ppt, 'Left Content'); rights = find(ppt, '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(ppt); rptview(ppt);
Текстовое поле в понижении является полем, в которое можно добавить текст. Можно программно добавить или заменить содержимое текстового поля в представлении.
Создайте TextBox объект. Задайте местоположение и ширину текстового поля.
Добавьте текст при помощи add метод с TextBox объект.
Добавьте TextBox возразите против представления с помощью add метод с Presentation возразите или add метод с Slide объект.
Например:
import mlreportgen.ppt.* ppt = Presentation('myPresentation.pptx'); open(ppt); titleSlide = add(ppt,'Title Slide'); tb = TextBox(); tb.X = '2in'; tb.Y = '2in'; tb.Width = '5in'; add(tb,'Text for text box'); add(titleSlide,tb); close(ppt);
Чтобы добавить или заменить таблицу в представлении, используйте этот подход:
Добавьте таблицу непосредственно в понижение.
Замените заполнителя от размещения понижения с таблицей. Например, добавьте понижение с 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);