此页面由 Cloud Translation API 翻译。

Class SlidesApp

创建并打开可修改的 Presentations。

// Open a presentation by ID.
var preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

属性

属性	类型	说明
`AlignmentPosition`	`AlignmentPosition`	对齐位置类型的枚举。
`ArrowStyle`	`ArrowStyle`	枚举 `Line` 可以采用的不同箭头样式。
`AutoTextType`	`AutoTextType`	自动文本类型的枚举。
`AutofitType`	`AutofitType`	自动调整类型的枚举。
`CellMergeState`	`CellMergeState`	一个枚举表单元格的不同合并状态。
`ColorType`	`ColorType`	颜色类型的枚举。
`ContentAlignment`	`ContentAlignment`	用于指定内容对齐方式的值枚举。
`DashStyle`	`DashStyle`	枚举 `Line` 可以采用的不同短划线样式。
`FillType`	`FillType`	填充类型的枚举。
`LineCategory`	`LineCategory`	`Line` 的类别枚举。
`LineFillType`	`LineFillType`	`LineFill` 类型的枚举。
`LineType`	`LineType`	`Line` 类型的枚举。
`LinkType`	`LinkType`	链接类型枚举。
`ListPreset`	`ListPreset`	列表预设类型的枚举。
`PageBackgroundType`	`PageBackgroundType`	页面背景类型的枚举。
`PageElementType`	`PageElementType`	页面元素类型的枚举。
`PageType`	`PageType`	页面类型的枚举。
`ParagraphAlignment`	`ParagraphAlignment`	段落对齐类型的枚举。
`PlaceholderType`	`PlaceholderType`	占位符类型的枚举。
`PredefinedLayout`	`PredefinedLayout`	预定义布局的枚举。
`SelectionType`	`SelectionType`	选择类型的枚举。
`ShapeType`	`ShapeType`	形状类型的枚举。
`SheetsChartEmbedType`	`SheetsChartEmbedType`	表格图表嵌入类型的枚举。
`SlideLinkingMode`	`SlideLinkingMode`	枚举幻灯片的链接方式。
`SlidePosition`	`SlidePosition`	幻灯片位置类型的枚举。
`SpacingMode`	`SpacingMode`	间距模式类型的枚举。
`TextBaselineOffset`	`TextBaselineOffset`	文本基线偏移类型的枚举。
`TextDirection`	`TextDirection`	文本路线类型的枚举。
`ThemeColorType`	`ThemeColorType`	主题颜色的枚举。
`VideoSourceType`	`VideoSourceType`	视频来源类型的枚举。

方法

方法	返回类型	简介
`create(name)`	`Presentation`	创建并打开新的 `Presentation`。
`getActivePresentation()`	`Presentation`	返回脚本与容器绑定的当前活动演示文稿，如果没有容器，则返回 `null` 展示。
`getUi()`	`Ui`	返回演示文稿界面环境的实例，通过该实例，脚本可以以便添加菜单、对话框和边栏等功能。
`newAffineTransformBuilder()`	`AffineTransformBuilder`	返回新的 `AffineTransformBuilder` 以构建 `AffineTransform`。
`openById(id)`	`Presentation`	打开具有指定 ID 的 `Presentation`。
`openByUrl(url)`	`Presentation`	使用指定网址打开 `Presentation`。

详细文档

`create(name)`

创建并打开新的 Presentation。

参数

名称	类型	说明
`name`	`String`	要为所创建的演示文稿指定的名称。

Presentation - 具有指定名称的演示文稿。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/presentations

`getActivePresentation()`

返回脚本与容器绑定的当前活动演示文稿，如果没有容器，则返回 null 展示。与未访问脚本的演示文稿进行交互容器绑定，请改用 openById(id)。

// Get the current presentation to which this script is bound.
var presentation = SlidesApp.getActivePresentation();

如果演示文稿已经打开，则返回相同的演示文稿实例。

Presentation

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getUi()`

返回演示文稿界面环境的实例，通过该实例，脚本可以以便添加菜单、对话框和边栏等功能。脚本只能与打开演示文稿的当前实例，并且仅在该脚本绑定到演示文稿时执行。如需了解详情，请参阅菜单和对话框和边栏指南。

// Add a custom menu to the active presentation, including a separator and a sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SlidesApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Ui

`newAffineTransformBuilder()`

返回新的 AffineTransformBuilder 以构建 AffineTransform。构建器预设了恒等式仿射转换。

AffineTransformBuilder

`openById(id)`

打开具有指定 ID 的 Presentation。

// Open a presentation by ID.
var presentation = SlidesApp.openById('docId');

如果演示文稿已经打开，则返回相同的演示文稿实例。

参数

名称	类型	说明
`id`	`String`

Presentation - 具有指定 ID 的演示文稿

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/presentations

`openByUrl(url)`

使用指定网址打开 Presentation。

// Open a presentation by URL.
var presentation = SlidesApp.openByUrl('https://docs.google.com/presentation/d/docId/edit');

如果演示文稿已经打开，则返回相同的演示文稿实例。

参数

名称	类型	说明
`url`	`String`

Presentation - 具有指定网址的演示文稿

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/presentations