Class NotesPage

“记事”页面

演示文稿中的备注页面。

这些页面包含演示文稿讲义的内容，其中包括一个含有幻灯片演讲者备注的形状。每张幻灯片都有一个对应的备注页面。只有演讲者备注形状中的文本可以修改。

方法

方法返回类型简介
getGroups()Group[]返回页面上的 Group 对象列表。
getImages()Image[]返回页面上的 Image 对象列表。
getLines()Line[]返回页面上的 Line 对象列表。
getObjectId()String获取网页的唯一 ID。
getPageElementById(id)PageElement返回具有给定 ID 的页面上的 PageElement；如果不存在，则返回 null。
getPageElements()PageElement[]返回在页面上呈现的 PageElement 对象的列表。
getPlaceholder(placeholderType)PageElement返回指定 PlaceholderType 或 null 的占位符 PageElement 对象（如果没有匹配的占位符，则返回 null）。
getPlaceholder(placeholderType, placeholderIndex)PageElement返回指定 PlaceholderType 的占位符 PageElement 对象和占位符索引，如果不存在占位符，则返回 null。
getPlaceholders()PageElement[]返回页面中的占位符 PageElement 对象的列表。
getShapes()Shape[]返回页面上的 Shape 对象列表。
getSheetsCharts()SheetsChart[]返回页面上的 SheetsChart 对象列表。
getSpeakerNotesShape()Shape获取页面上包含演讲者备注的形状。
getTables()Table[]返回页面上的 Table 对象列表。
getVideos()Video[]返回页面上的 Video 对象列表。
getWordArts()WordArt[]返回页面上的 WordArt 对象列表。
replaceAllText(findText, replaceText)Integer将与查找文本匹配的所有文本替换为替换文本。
replaceAllText(findText, replaceText, matchCase)Integer将与查找文本匹配的所有文本替换为替换文本。

详细文档

getGroups()

返回页面上的 Group 对象列表。

返回

Group[]

授权

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

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

getImages()

返回页面上的 Image 对象列表。

返回

Image[]

授权

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

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

getLines()

返回页面上的 Line 对象列表。

返回

Line[]

授权

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

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

getObjectId()

获取网页的唯一 ID。页面和页面元素使用的对象 ID 共用相同的命名空间。

返回

String

授权

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

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

getPageElementById(id)

返回具有给定 ID 的页面上的 PageElement；如果不存在，则返回 null。

参数

名称类型说明
idString要检索的页面元素的 ID。

返回

PageElement - 具有指定 ID 的页面元素。

授权

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

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

getPageElements()

返回在页面上呈现的 PageElement 对象的列表。

返回

PageElement[]

授权

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

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

getPlaceholder(placeholderType)

返回指定 PlaceholderType 或 null 的占位符 PageElement 对象（如果没有匹配的占位符，则返回 null）。

如果存在多个类型相同的占位符，则返回占位符索引最小的占位符。如果有多个具有相同索引的匹配占位符，则会返回网页的网页元素集合中的第一个占位符。 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

参数

名称类型说明
placeholderTypePlaceholderType

返回

PageElement

授权

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

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

getPlaceholder(placeholderType, placeholderIndex)

返回指定 PlaceholderType 的占位符 PageElement 对象和占位符索引，如果不存在占位符，则返回 null。

如果有多个占位符具有相同的类型和索引，则会返回网页的网页元素集合中的第一个占位符。 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

参数

名称类型说明
placeholderTypePlaceholderType
placeholderIndexInteger

返回

PageElement

授权

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

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

getPlaceholders()

返回页面中的占位符 PageElement 对象的列表。 

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

返回

PageElement[]

授权

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

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

getShapes()

返回页面上的 Shape 对象列表。

返回

Shape[]

授权

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

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

getSheetsCharts()

返回页面上的 SheetsChart 对象列表。

返回

SheetsChart[]

授权

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

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

getSpeakerNotesShape()

获取页面上包含演讲者备注的形状。

返回

Shape

授权

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

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

getTables()

返回页面上的 Table 对象列表。

返回

Table[]

授权

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

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

getVideos()

返回页面上的 Video 对象列表。

返回

Video[]

授权

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

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

getWordArts()

返回页面上的 WordArt 对象列表。

返回

WordArt[]

授权

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

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

replaceAllText(findText, replaceText)

将与查找文本匹配的所有文本替换为替换文本。搜索不区分大小写。

参数

名称类型说明
findTextString要查找的文本。
replaceTextString要替换匹配文本的文本。

返回

Integer - 发生次数的更改

授权

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

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

replaceAllText(findText, replaceText, matchCase)

将与查找文本匹配的所有文本替换为替换文本。

参数

名称类型说明
findTextString要查找的文本。
replaceTextString要替换匹配文本的文本。
matchCaseBoolean如果为 true，则搜索区分大小写；如果为 false，则搜索不区分大小写。

返回

Integer - 发生次数的更改

授权

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

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