Class SlidesApp

幻灯片应用

创建并打开可修改的 Presentations。

// Open a presentation by ID.
let 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	Sheets 图表嵌入类型的枚举。
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.
const 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.
const presentation = SlidesApp.openById('docId');

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

参数

名称	类型	说明
id	String

返回

Presentation - 具有指定 ID 的演示

授权

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

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

---

openByUrl(url)

使用给定网址打开 Presentation。

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

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

参数

名称	类型	说明
url	String

返回

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

授权

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

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