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');

属性

属性类型说明
AlignmentPositionAlignmentPosition对齐位置类型的枚举。
ArrowStyleArrowStyle枚举了 Line 可以具有的不同箭头样式。
AutoTextTypeAutoTextType自动文本类型的枚举。
AutofitTypeAutofitType自动调整类型的枚举。
CellMergeStateCellMergeState表格单元格的不同合并状态的枚举。
ColorTypeColorType颜色类型的枚举。
ContentAlignmentContentAlignment用于指定内容对齐方式的值枚举。
DashStyleDashStyle用于枚举 Line 可以具有的不同短划线样式。
FillTypeFillType填充类型的枚举。
LineCategoryLineCategoryLine 类别的枚举。
LineFillTypeLineFillTypeLineFill 类型的枚举。
LineTypeLineTypeLine 类型的枚举。
LinkTypeLinkType链接类型的枚举。
ListPresetListPreset列表预设类型的枚举。
PageBackgroundTypePageBackgroundType页面背景类型的枚举。
PageElementTypePageElementType页面元素类型的枚举。
PageTypePageType页面类型的枚举。
ParagraphAlignmentParagraphAlignment段落对齐方式的枚举。
PlaceholderTypePlaceholderType占位符类型的枚举。
PredefinedLayoutPredefinedLayout预定义布局的枚举。
SelectionTypeSelectionType选择类型的枚举。
ShapeTypeShapeType形状类型的枚举。
SheetsChartEmbedTypeSheetsChartEmbedTypeSheets 图表嵌入类型的枚举。
SlideLinkingModeSlideLinkingMode枚举了幻灯片的链接方式。
SlidePositionSlidePosition滑动位置类型的枚举。
SpacingModeSpacingMode间距模式类型的枚举。
TextBaselineOffsetTextBaselineOffset文本基线偏移类型的枚举。
TextDirectionTextDirection文本路线类型的枚举。
ThemeColorTypeThemeColorType主题颜色的枚举。
VideoSourceTypeVideoSourceType视频源类型的枚举。

方法

方法返回类型简介
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。

参数

名称类型说明
nameString要为创建的演示文稿指定的名称。

返回

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');
 如果演示文稿已打开，则返回相同的演示文稿实例。

参数

名称类型说明
idString

返回

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',
);
 如果演示文稿已打开，则返回相同的演示文稿实例。

参数

名称类型说明
urlString

返回

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

授权

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

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