Поделиться через


powerpoint package

Классы

PowerPoint.Application
PowerPoint.BulletFormat

Представляет свойства форматирования маркеров текста, присоединенного к формату PowerPoint.ParagraphFormat.

PowerPoint.CustomProperty

Представляет пользовательское свойство.

PowerPoint.CustomPropertyCollection

Коллекция настраиваемых свойств.

PowerPoint.CustomXmlPart

Представляет пользовательский объект части XML.

PowerPoint.CustomXmlPartCollection

Коллекция настраиваемых XML-частей.

PowerPoint.CustomXmlPartScopedCollection

Коллекция настраиваемых XML-частей с заданной областью. Коллекция с заданной областью является результатом некоторых операций (например, фильтрации по пространству имен). Коллекция с заданной областью больше не может быть ограничена.

PowerPoint.DocumentProperties

Представляет свойства презентации.

PowerPoint.Hyperlink

Представляет одну гиперссылку.

PowerPoint.HyperlinkCollection

Представляет коллекцию гиперссылок.

PowerPoint.ParagraphFormat

Представляет свойства форматирования абзаца текста, присоединенного к PowerPoint.TextRange.

PowerPoint.Presentation
PowerPoint.RequestContext

Объект RequestContext упрощает запросы к приложению PowerPoint. Так как надстройка Office и приложение PowerPoint выполняются в двух разных процессах, контекст запроса необходим для получения доступа к объектной модели PowerPoint из надстройки.

PowerPoint.Shape

Представляет одну фигуру на слайде.

PowerPoint.ShapeCollection

Представляет коллекцию фигур.

PowerPoint.ShapeFill

Представляет форматирование заливки объекта фигуры.

PowerPoint.ShapeFont

Представляет атрибуты шрифта, такие как имя шрифта, размер шрифта и цвет, для объекта TextRange фигуры.

PowerPoint.ShapeLineFormat

Представляет форматирование линий для объекта фигуры. Для изображений и геометрических фигур форматирование линий представляет границу фигуры.

PowerPoint.ShapeScopedCollection

Представляет коллекцию фигур.

PowerPoint.Slide

Представляет один слайд презентации.

PowerPoint.SlideCollection

Представляет коллекцию слайдов в презентации.

PowerPoint.SlideLayout

Представляет макет слайда.

PowerPoint.SlideLayoutCollection

Представляет коллекцию макетов, предоставляемых образцом слайдов для слайдов.

PowerPoint.SlideMaster

Представляет образец слайдов слайда.

PowerPoint.SlideMasterCollection

Представляет коллекцию образцов слайдов в презентации.

PowerPoint.SlideScopedCollection

Представляет коллекцию слайдов в презентации.

PowerPoint.Tag

Представляет один тег на слайде.

PowerPoint.TagCollection

Представляет коллекцию тегов.

PowerPoint.TextFrame

Представляет текстовый кадр объекта фигуры.

PowerPoint.TextRange

Содержит текст, присоединенный к фигуре, в дополнение к свойствам и методам для управления текстом.

Интерфейсы

PowerPoint.AddSlideOptions

Представляет доступные параметры при добавлении нового слайда.

PowerPoint.InsertSlideOptions

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

PowerPoint.Interfaces.BulletFormatData

Интерфейс, описывающий данные, возвращаемые путем вызова bulletFormat.toJSON().

PowerPoint.Interfaces.BulletFormatLoadOptions

Представляет свойства форматирования маркеров текста, присоединенного к формату PowerPoint.ParagraphFormat.

PowerPoint.Interfaces.BulletFormatUpdateData

Интерфейс для обновления данных объекта BulletFormat для использования в bulletFormat.set({ ... }).

PowerPoint.Interfaces.CollectionLoadOptions

Предоставляет способы загрузки свойств только подмножества элементов коллекции.

PowerPoint.Interfaces.CustomPropertyCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова customPropertyCollection.toJSON().

PowerPoint.Interfaces.CustomPropertyCollectionLoadOptions

Коллекция настраиваемых свойств.

PowerPoint.Interfaces.CustomPropertyCollectionUpdateData

Интерфейс для обновления данных объекта CustomPropertyCollection для использования в customPropertyCollection.set({ ... }).

PowerPoint.Interfaces.CustomPropertyData

Интерфейс, описывающий данные, возвращаемые путем вызова customProperty.toJSON().

PowerPoint.Interfaces.CustomPropertyLoadOptions

Представляет пользовательское свойство.

PowerPoint.Interfaces.CustomPropertyUpdateData

Интерфейс для обновления данных объекта CustomProperty для использования в customProperty.set({ ... }).

PowerPoint.Interfaces.CustomXmlPartCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова customXmlPartCollection.toJSON().

PowerPoint.Interfaces.CustomXmlPartCollectionLoadOptions

Коллекция настраиваемых XML-частей.

PowerPoint.Interfaces.CustomXmlPartCollectionUpdateData

Интерфейс для обновления данных объекта CustomXmlPartCollection для использования в customXmlPartCollection.set({ ... }).

PowerPoint.Interfaces.CustomXmlPartData

Интерфейс, описывающий данные, возвращаемые путем вызова customXmlPart.toJSON().

PowerPoint.Interfaces.CustomXmlPartLoadOptions

Представляет пользовательский объект части XML.

PowerPoint.Interfaces.CustomXmlPartScopedCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова customXmlPartScopedCollection.toJSON().

PowerPoint.Interfaces.CustomXmlPartScopedCollectionLoadOptions

Коллекция настраиваемых XML-частей с заданной областью. Коллекция с заданной областью является результатом некоторых операций (например, фильтрации по пространству имен). Коллекция с заданной областью больше не может быть ограничена.

PowerPoint.Interfaces.CustomXmlPartScopedCollectionUpdateData

Интерфейс для обновления данных объекта CustomXmlPartScopedCollection для использования в customXmlPartScopedCollection.set({ ... }).

PowerPoint.Interfaces.DocumentPropertiesData

Интерфейс, описывающий данные, возвращаемые путем вызова documentProperties.toJSON().

PowerPoint.Interfaces.DocumentPropertiesLoadOptions

Представляет свойства презентации.

PowerPoint.Interfaces.DocumentPropertiesUpdateData

Интерфейс для обновления данных объекта DocumentProperties для использования в documentProperties.set({ ... }).

PowerPoint.Interfaces.HyperlinkCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова hyperlinkCollection.toJSON().

PowerPoint.Interfaces.HyperlinkCollectionLoadOptions

Представляет коллекцию гиперссылок.

PowerPoint.Interfaces.HyperlinkCollectionUpdateData

Интерфейс для обновления данных объекта HyperlinkCollection для использования в hyperlinkCollection.set({ ... }).

PowerPoint.Interfaces.HyperlinkData

Интерфейс, описывающий данные, возвращаемые путем вызова hyperlink.toJSON().

PowerPoint.Interfaces.HyperlinkLoadOptions

Представляет одну гиперссылку.

PowerPoint.Interfaces.HyperlinkUpdateData

Интерфейс для обновления данных объекта Hyperlink для использования в hyperlink.set({ ... }).

PowerPoint.Interfaces.ParagraphFormatData

Интерфейс, описывающий данные, возвращаемые путем вызова paragraphFormat.toJSON().

PowerPoint.Interfaces.ParagraphFormatLoadOptions

Представляет свойства форматирования абзаца текста, присоединенного к PowerPoint.TextRange.

PowerPoint.Interfaces.ParagraphFormatUpdateData

Интерфейс для обновления данных объекта ParagraphFormat для использования в paragraphFormat.set({ ... }).

PowerPoint.Interfaces.PresentationData

Интерфейс, описывающий данные, возвращаемые путем вызова presentation.toJSON().

PowerPoint.Interfaces.PresentationLoadOptions
PowerPoint.Interfaces.ShapeCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова shapeCollection.toJSON().

PowerPoint.Interfaces.ShapeCollectionLoadOptions

Представляет коллекцию фигур.

PowerPoint.Interfaces.ShapeCollectionUpdateData

Интерфейс для обновления данных объекта ShapeCollection для использования в shapeCollection.set({ ... }).

PowerPoint.Interfaces.ShapeData

Интерфейс, описывающий данные, возвращаемые путем вызова shape.toJSON().

PowerPoint.Interfaces.ShapeFillData

Интерфейс, описывающий данные, возвращаемые путем вызова shapeFill.toJSON().

PowerPoint.Interfaces.ShapeFillLoadOptions

Представляет форматирование заливки объекта фигуры.

PowerPoint.Interfaces.ShapeFillUpdateData

Интерфейс для обновления данных объекта ShapeFill для использования в shapeFill.set({ ... }).

PowerPoint.Interfaces.ShapeFontData

Интерфейс, описывающий данные, возвращаемые путем вызова shapeFont.toJSON().

PowerPoint.Interfaces.ShapeFontLoadOptions

Представляет атрибуты шрифта, такие как имя шрифта, размер шрифта и цвет, для объекта TextRange фигуры.

PowerPoint.Interfaces.ShapeFontUpdateData

Интерфейс для обновления данных объекта ShapeFont для использования в shapeFont.set({ ... }).

PowerPoint.Interfaces.ShapeLineFormatData

Интерфейс, описывающий данные, возвращаемые путем вызова shapeLineFormat.toJSON().

PowerPoint.Interfaces.ShapeLineFormatLoadOptions

Представляет форматирование линий для объекта фигуры. Для изображений и геометрических фигур форматирование линий представляет границу фигуры.

PowerPoint.Interfaces.ShapeLineFormatUpdateData

Интерфейс для обновления данных объекта ShapeLineFormat для использования в shapeLineFormat.set({ ... }).

PowerPoint.Interfaces.ShapeLoadOptions

Представляет одну фигуру на слайде.

PowerPoint.Interfaces.ShapeScopedCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова shapeScopedCollection.toJSON().

PowerPoint.Interfaces.ShapeScopedCollectionLoadOptions

Представляет коллекцию фигур.

PowerPoint.Interfaces.ShapeScopedCollectionUpdateData

Интерфейс для обновления данных объекта ShapeScopedCollection для использования в shapeScopedCollection.set({ ... }).

PowerPoint.Interfaces.ShapeUpdateData

Интерфейс для обновления данных объекта Shape для использования в shape.set({ ... }).

PowerPoint.Interfaces.SlideCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова slideCollection.toJSON().

PowerPoint.Interfaces.SlideCollectionLoadOptions

Представляет коллекцию слайдов в презентации.

PowerPoint.Interfaces.SlideCollectionUpdateData

Интерфейс для обновления данных объекта SlideCollection для использования в slideCollection.set({ ... }).

PowerPoint.Interfaces.SlideData

Интерфейс, описывающий данные, возвращаемые путем вызова slide.toJSON().

PowerPoint.Interfaces.SlideLayoutCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова slideLayoutCollection.toJSON().

PowerPoint.Interfaces.SlideLayoutCollectionLoadOptions

Представляет коллекцию макетов, предоставляемых образцом слайдов для слайдов.

PowerPoint.Interfaces.SlideLayoutCollectionUpdateData

Интерфейс для обновления данных объекта SlideLayoutCollection для использования в slideLayoutCollection.set({ ... }).

PowerPoint.Interfaces.SlideLayoutData

Интерфейс, описывающий данные, возвращаемые путем вызова slideLayout.toJSON().

PowerPoint.Interfaces.SlideLayoutLoadOptions

Представляет макет слайда.

PowerPoint.Interfaces.SlideLoadOptions

Представляет один слайд презентации.

PowerPoint.Interfaces.SlideMasterCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова slideMasterCollection.toJSON().

PowerPoint.Interfaces.SlideMasterCollectionLoadOptions

Представляет коллекцию образцов слайдов в презентации.

PowerPoint.Interfaces.SlideMasterCollectionUpdateData

Интерфейс для обновления данных объекта SlideMasterCollection для использования в slideMasterCollection.set({ ... }).

PowerPoint.Interfaces.SlideMasterData

Интерфейс, описывающий данные, возвращаемые путем вызова slideMaster.toJSON().

PowerPoint.Interfaces.SlideMasterLoadOptions

Представляет образец слайдов слайда.

PowerPoint.Interfaces.SlideScopedCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова slideScopedCollection.toJSON().

PowerPoint.Interfaces.SlideScopedCollectionLoadOptions

Представляет коллекцию слайдов в презентации.

PowerPoint.Interfaces.SlideScopedCollectionUpdateData

Интерфейс для обновления данных объекта SlideScopedCollection для использования в slideScopedCollection.set({ ... }).

PowerPoint.Interfaces.TagCollectionData

Интерфейс, описывающий данные, возвращаемые путем вызова tagCollection.toJSON().

PowerPoint.Interfaces.TagCollectionLoadOptions

Представляет коллекцию тегов.

PowerPoint.Interfaces.TagCollectionUpdateData

Интерфейс для обновления данных объекта TagCollection для использования в tagCollection.set({ ... }).

PowerPoint.Interfaces.TagData

Интерфейс, описывающий данные, возвращаемые путем вызова tag.toJSON().

PowerPoint.Interfaces.TagLoadOptions

Представляет один тег на слайде.

PowerPoint.Interfaces.TagUpdateData

Интерфейс для обновления данных объекта Tag для использования в tag.set({ ... }).

PowerPoint.Interfaces.TextFrameData

Интерфейс, описывающий данные, возвращаемые путем вызова textFrame.toJSON().

PowerPoint.Interfaces.TextFrameLoadOptions

Представляет текстовый кадр объекта фигуры.

PowerPoint.Interfaces.TextFrameUpdateData

Интерфейс для обновления данных объекта TextFrame для использования в textFrame.set({ ... }).

PowerPoint.Interfaces.TextRangeData

Интерфейс, описывающий данные, возвращаемые путем вызова textRange.toJSON().

PowerPoint.Interfaces.TextRangeLoadOptions

Содержит текст, присоединенный к фигуре, в дополнение к свойствам и методам для управления текстом.

PowerPoint.Interfaces.TextRangeUpdateData

Интерфейс для обновления данных объекта TextRange для использования в textRange.set({ ... }).

PowerPoint.ShapeAddOptions

Представляет доступные параметры при добавлении фигур.

PowerPoint.SlideGetImageOptions

Представляет доступные параметры при получении изображения слайда.

Перечисления

PowerPoint.ConnectorType

Указывает тип соединителя для фигур линий.

PowerPoint.DocumentPropertyType

Указывает тип свойства документа для пользовательских свойств.

PowerPoint.ErrorCodes
PowerPoint.GeometricShapeType

Указывает тип фигуры для GeometricShape объекта.

PowerPoint.InsertSlideFormatting

Задает параметры форматирования при вставке слайдов.

PowerPoint.ParagraphHorizontalAlignment

Представляет горизонтальное выравнивание элемента PowerPoint.TextFrame в PowerPoint.Shape.

PowerPoint.ShapeAutoSize

Определяет тип разрешенного автоматического изменения размера.

PowerPoint.ShapeFillType

Указывает тип заливки фигуры.

PowerPoint.ShapeFontUnderlineStyle

Тип подчеркивания, примененного к шрифту.

PowerPoint.ShapeLineDashStyle

Задает стиль дефиса для строки.

PowerPoint.ShapeLineStyle

Задает стиль строки.

PowerPoint.ShapeType

Указывает тип фигуры.

PowerPoint.TextVerticalAlignment

Представляет вертикальное выравнивание элемента PowerPoint.TextFrame в PowerPoint.Shape. Если выбран один из параметров по центру, содержимое TextFrame будет отцентрировано по горизонтали внутри Shape в виде группы. Сведения об изменении горизонтального выравнивания текста см. в разделах PowerPoint.ParagraphFormat и PowerPoint.ParagraphHorizontalAlignment.

Функции

PowerPoint.createPresentation(base64File)

Создает и открывает новую презентацию. При необходимости презентацию можно предварительно заполнить файлом .pptx в кодировке Base64.

[ Набор API: PowerPointApi 1.1 ]

PowerPoint.run(batch)

Выполняет пакетный скрипт, выполняющий действия с объектной моделью PowerPoint, используя новый requestContext. При разрешении обещания все отслеживаемые объекты, которые были автоматически выделены во время выполнения, будут освобождены.

PowerPoint.run(object, batch)

Выполняет пакетный скрипт, который выполняет действия в объектной модели PowerPoint, используя RequestContext ранее созданного объекта API. При разрешении обещания все отслеживаемые объекты, которые были автоматически выделены во время выполнения, будут освобождены.

PowerPoint.run(objects, batch)

Выполняет пакетный скрипт, который выполняет действия в объектной модели PowerPoint, используя RequestContext ранее созданных объектов API.

Сведения о функции

PowerPoint.createPresentation(base64File)

Создает и открывает новую презентацию. При необходимости презентацию можно предварительно заполнить файлом .pptx в кодировке Base64.

[ Набор API: PowerPointApi 1.1 ]

export function createPresentation(base64File?: string): Promise<void>;

Параметры

base64File

string

Необязательный параметр. Файл .pptx в кодировке Base64. По умолчанию используется значение NULL.

Возвращаемое значение

Promise<void>

Примеры

const myFile = <HTMLInputElement>document.getElementById("file");
const reader = new FileReader();

reader.onload = (event) => {
  // Remove the metadata before the base64-encoded string.
  const startIndex = reader.result.toString().indexOf("base64,");
  const copyBase64 = reader.result.toString().substr(startIndex + 7);

  PowerPoint.createPresentation(copyBase64);
};

// Read in the file as a data URL so we can parse the base64-encoded string.
reader.readAsDataURL(myFile.files[0]);

PowerPoint.run(batch)

Выполняет пакетный скрипт, выполняющий действия с объектной моделью PowerPoint, используя новый requestContext. При разрешении обещания все отслеживаемые объекты, которые были автоматически выделены во время выполнения, будут освобождены.

export function run<T>(batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

Параметры

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

Функция, которая принимает requestContext и возвращает обещание (как правило, только результат "context.sync()"). Параметр контекста упрощает запросы к приложению PowerPoint. Так как надстройка Office и приложение PowerPoint выполняются в двух разных процессах, requestContext требуется для получения доступа к объектной модели PowerPoint из надстройки.

Возвращаемое значение

PowerPoint.run(object, batch)

Выполняет пакетный скрипт, который выполняет действия в объектной модели PowerPoint, используя RequestContext ранее созданного объекта API. При разрешении обещания все отслеживаемые объекты, которые были автоматически выделены во время выполнения, будут освобождены.

export function run<T>(object: OfficeExtension.ClientObject, batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

Параметры

object
OfficeExtension.ClientObject

Ранее созданный объект API. Пакет будет использовать тот же объект RequestContext, что и переданный объект. Это означает, что все изменения, примененные к объекту, будут приняты командой context.sync().

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

Функция, которая принимает requestContext и возвращает обещание (как правило, только результат "context.sync()"). Параметр контекста упрощает запросы к приложению PowerPoint. Так как надстройка Office и приложение PowerPoint выполняются в двух разных процессах, requestContext требуется для получения доступа к объектной модели PowerPoint из надстройки.

Возвращаемое значение

PowerPoint.run(objects, batch)

Выполняет пакетный скрипт, который выполняет действия в объектной модели PowerPoint, используя RequestContext ранее созданных объектов API.

export function run<T>(objects: OfficeExtension.ClientObject[], batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

Параметры

objects

OfficeExtension.ClientObject[]

Массив ранее созданных объектов API. Массив будет проверен, чтобы убедиться, что все объекты имеют один и тот же контекст. Пакет будет использовать этот общий requestContext, что означает, что любые изменения, примененные к этим объектам, будут приняты командой context.sync().

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

Функция, которая принимает requestContext и возвращает обещание (как правило, только результат "context.sync()"). Параметр контекста упрощает запросы к приложению PowerPoint. Так как надстройка Office и приложение PowerPoint выполняются в двух разных процессах, requestContext требуется для получения доступа к объектной модели PowerPoint из надстройки.

Возвращаемое значение