Class NotesPage

备注页面

演示文稿中的备注页。

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

方法

方法返回类型简介
getGroups()Group[]返回页面上 Group 对象的列表。
getImages()Image[]返回页面上 Image 对象的列表。
getLines()Line[]返回页面上 Line 对象的列表。
getObjectId()String获取网页的唯一 ID。
getPageElementById(id)PageElement|null返回具有指定 ID 的页面上的 PageElement，如果不存在，则返回 null。
getPageElements()PageElement[]返回页面上呈现的 PageElement 对象列表。
getPlaceholder(placeholderType)PageElement|null返回指定 PlaceholderType 的占位符 PageElement 对象，如果不存在匹配的占位符，则返回 null。
getPlaceholder(placeholderType, placeholderIndex)PageElement|null返回指定 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|null - 具有指定 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 的占位符 PageElement 对象，如果不存在匹配的占位符，则返回 null。

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

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

参数

名称类型说明
placeholderTypePlaceholderType

返回

PageElement|null

授权

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

  • 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|null

授权

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

  • 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