Class Link

链接

超文本链接。

方法

方法返回类型简介
getLinkType()LinkType返回 LinkType
getLinkedSlide()Slide针对非网址链接类型返回已链接的 Slide(如果存在)。
getSlideId()String返回关联的 Slide 的 ID,如果 LinkType 不是,则返回 null LinkType.SLIDE_ID
getSlideIndex()Integer返回关联的 Slide 的索引(从零开始),如果 LinkType 不为 LinkType.SLIDE_INDEX,则返回 null
getSlidePosition()SlidePosition返回关联的 SlideSlidePosition,如果 LinkType 不是 LinkType.SLIDE_POSITION,则返回 null
getUrl()String返回外部网页的网址,如果 LinkType 不是 LinkType.URL,则返回 null

详细文档

getLinkType()

返回 LinkType

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

返回

LinkType

授权

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

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

getLinkedSlide()

针对非网址链接类型返回已链接的 Slide(如果存在)。如果存在以下情况,则返回 null: 演示文稿中不存在幻灯片,或者如果 LinkTypeLinkType.URL

var link = shape.getLink();
if (link != null && link.getLinkType() != SlidesApp.LinkType.URL) {
  Logger.log('Shape has link to slide: ' + link.getLinkedSlide());
}

返回

Slide

授权

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

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

getSlideId()

返回关联的 Slide 的 ID,如果 LinkType 不是,则返回 null LinkType.SLIDE_ID

请注意,所返回 ID 对应的幻灯片可能不存在。

var link = shape.getLink();
if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_ID) {
  Logger.log('Shape has link to slide with ID: ' + link.getSlideId());
}

返回

String

授权

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

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

getSlideIndex()

返回关联的 Slide 的索引(从零开始),如果 LinkType 不为 LinkType.SLIDE_INDEX,则返回 null

请注意,返回的索引处的幻灯片可能不存在。

var link = shape.getLink();
if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_INDEX) {
  Logger.log('Shape has link to slide with index: ' + link.getSlideIndex());
}

返回

Integer

授权

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

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

getSlidePosition()

返回关联的 SlideSlidePosition,如果 LinkType 不是 LinkType.SLIDE_POSITION,则返回 null

请注意,返回的相对位置的幻灯片可能不存在。

var link = shape.getLink();
if (link != null && link.getLinkType() == SlidesApp.LinkType.SLIDE_POSITION) {
  Logger.log('Shape has link to slide with relative position: ' + link.getSlidePosition());
}

返回

SlidePosition

授权

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

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

getUrl()

返回外部网页的网址,如果 LinkType 不是 LinkType.URL,则返回 null

var link = shape.getLink();
if (link != null && link.getLinkType() == SlidesApp.LinkType.URL) {
  Logger.log('Shape has link to URL: ' + link.getUrl());
}

返回

String

授权

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

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