表示线条的 PageElement
。
方法
详细文档
alignOnPage(alignmentPosition)
将元素与页面上的指定对齐位置对齐。
参数
名称 | 类型 | 说明 |
---|---|---|
alignmentPosition | AlignmentPosition | 此网页元素在页面上的对齐位置。 |
弃踢回攻
Line
- 此页面元素,用于链接。
bringForward()
bringToFront()
duplicate()
复制页面元素。
复制的页面元素会放置在与原始网页相同的页面上。
弃踢回攻
PageElement
- 此网页元素的新副本。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
返回页面元素上的 ConnectionSite
列表;如果页面元素没有任何连接站点,则返回空列表。
弃踢回攻
ConnectionSite[]
- 连接站点列表,如果此元素没有连接站点,则可能为空。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDashStyle()
getDescription()
返回页面元素的替代文本说明。说明会与标题合并,以显示和阅读替代文本。
弃踢回攻
String
- 页面元素的替代文本说明。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEnd()
getEndArrow()
获取线条末尾的箭头 ArrowStyle
。
弃踢回攻
ArrowStyle
- 此线条末尾的箭头的样式。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndConnection()
返回线条末尾的连接,如果没有连接,则返回 null
。
弃踢回攻
ConnectionSite
- 线条末尾的连接。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
getInherentHeight()
返回元素的固有高度(以点为单位)。
页面元素的转换与其固有大小相关。将固有尺寸与元素的转换结合使用来确定元素的最终视觉外观。
弃踢回攻
Number
- 页面元素的固有高度(以点为单位),如果页面元素没有高度,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
返回元素的固有宽度(以点为单位)。
页面元素的转换与其固有大小相关。将固有尺寸与元素的转换结合使用来确定元素的最终视觉外观。
弃踢回攻
Number
- 页面元素的固有宽度(以点为单位),如果页面元素没有宽度,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
返回元素的水平位置(以点为单位),当元素没有旋转时,从页面左上角开始测量。
弃踢回攻
Number
- 此元素的水平位置(以点为单位),从页面左上角开始。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineCategory()
获取线条的 LineCategory
。
弃踢回攻
LineCategory
- 线条类别。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineFill()
getLineType()
getLink()
getObjectId()
返回此对象的唯一 ID。页面和页面元素使用的对象 ID 共用同一个命名空间。
弃踢回攻
String
- 此对象的唯一 ID。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
返回页面元素的类型,表示为 PageElementType
枚举。
弃踢回攻
PageElementType
- 页面元素的类型。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
getParentPage()
getRotation()
返回元素围绕其中心的顺时针旋转角度(以度为单位),其中 0 度表示不旋转。
弃踢回攻
Number
- 旋转角度,以 0(含)到 360(不含)之间的度为单位。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStart()
getStartArrow()
获取行首箭头的 ArrowStyle
。
弃踢回攻
ArrowStyle
- 此线条开头的箭头的样式。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartConnection()
返回线条开头的连接,如果没有连接,则返回 null
。
弃踢回攻
ConnectionSite
- 行首的连接。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
返回页面元素的替代文本标题。系统会将标题与说明合并到一起显示和阅读替代文本。
弃踢回攻
String
- 页面元素的替代文本标题。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
获取元素的垂直位置(以点为单位),当元素没有旋转时,从页面左上角开始测量。
弃踢回攻
Number
- 此元素的垂直位置(以点为单位),从页面左上角开始计算。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
返回页面元素的转换。
页面元素的视觉外观由其绝对转换决定。要计算绝对转换,请将页面元素的转换与其所有父组的转换预串联。如果页面元素不在组中,其绝对转换值与此字段中的值相同。
弃踢回攻
AffineTransform
- 页面元素的转换。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWeight()
返回线的粗细(以点为单位)。
弃踢回攻
Number
- 线条的粗细(以点为单位)。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
isConnector()
如果该行是连接器,则返回 true
,否则返回 false
。
连接器是一种线,用于连接适用页面元素上的连接网站。连接器的每一端最多只能连接到一个连接点。
弃踢回攻
Boolean
- 如果相应行是连接器,则为 True
,否则为 false
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
将提供的转换与页面元素的现有转换预串联。
newTransform = argument * existingTransform
例如,要将页面元素向左移动 36 个点,请执行以下操作:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
您还可以将页面元素的转换替换为 setTransform(transform)
。
参数
名称 | 类型 | 说明 |
---|---|---|
transform | AffineTransform | 要预串联到此页面元素的转换的转换。 |
弃踢回攻
Line
- 此页面元素,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
移除页面元素。
如果在执行移除操作之后,Group
只包含一个页面元素或不包含任何页面元素,则群组本身也会被移除。
如果移除母版或布局上的占位符 PageElement
,则所有空的继承占位符也会被移除。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
移除 Link
。
shape.removeLink();
reroute()
scaleHeight(ratio)
scaleWidth(ratio)
select()
仅选择当前演示中的 PageElement
,并移除之前的所有选择。这相当于使用 true
调用 select(replace)
。
仅当脚本已绑定到演示文稿时,脚本才能访问运行该脚本的用户的所选内容。
这会将 PageElement
的父级 Page
设置为 current page selection
。
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
在当前演示文稿中选择 PageElement
。
仅当脚本已绑定到演示文稿时,脚本才能访问运行该脚本的用户的所选内容。
将 true
传递给此方法,即可仅选择 PageElement
并移除之前的所有选择。此外,这还会将 PageElement
的父级 Page
设置为 current page selection
。
传递 false
以选择多个 PageElement
对象。PageElement
对象必须位于同一 Page
中。
使用 false
参数选择页面元素时,必须满足以下条件:
PageElement
对象的父级Page
必须是current page selection
。- 不得选择多个
Page
对象。
为了确保能够做到这一点,首选方法是先使用 Page.selectAsCurrentPage()
选择父 Page
,然后选择该页面中的页面元素。
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. var pageElements = slide.getPageElements(); for (var i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
参数
名称 | 类型 | 说明 |
---|---|---|
replace | Boolean | 如果为 true ,所选内容将替换之前的所有选择;否则,所选内容会添加到之前的所有选择中。 |
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
sendToBack()
setDashStyle(style)
setDescription(description)
设置页面元素的替代文本说明。
Group
元素不支持此方法。
// Set the first page element's alt text description to "new alt text description". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
参数
名称 | 类型 | 说明 |
---|---|---|
description | String | 要为替代文本说明设置的字符串。 |
弃踢回攻
Line
- 此页面元素。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(left, top)
setEnd(point)
setEndArrow(style)
设置线条末尾箭头的 ArrowStyle
。
参数
名称 | 类型 | 说明 |
---|---|---|
style | ArrowStyle | 要设置的样式。 |
弃踢回攻
Line
- 此行,用于串联。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndConnection(connectionSite)
设置线条末尾的连接。它会将线条的末端移动到指定的连接点,同时保持另一端不变。
参数
名称 | 类型 | 说明 |
---|---|---|
connectionSite | ConnectionSite | 结束连接已更新到的连接站点,如果移除该端连接,则为 null 。 |
弃踢回攻
Line
- 线条。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
setLeft(left)
setLineCategory(lineCategory)
设置线条的 LineCategory
。
您只能在 connectors
上设置类别。连接器类别在更改之后可能会被重新路由。
参数
名称 | 类型 | 说明 |
---|---|---|
lineCategory | LineCategory | 要设置的线条类别。 |
弃踢回攻
Line
- 线条。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
setLinkSlide(slide)
将 Link
设为指定的 Slide
,链接由指定的幻灯片 ID 设置。
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
参数
名称 | 类型 | 说明 |
---|---|---|
slide | Slide | 要关联的 Slide 。 |
弃踢回攻
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
参数
名称 | 类型 | 说明 |
---|---|---|
slidePosition | SlidePosition | 相对 SlidePosition 。 |
弃踢回攻
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
setRotation(angle)
setStart(left, top)
setStart(point)
setStartArrow(style)
设置线条起点箭头的 ArrowStyle
。
参数
名称 | 类型 | 说明 |
---|---|---|
style | ArrowStyle | 要设置的新箭头样式。 |
弃踢回攻
Line
- 此行,用于串联。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartConnection(connectionSite)
设置线条开头的连接。它会将线条的起点移动到指定的连接点,同时保持另一端不变。
参数
名称 | 类型 | 说明 |
---|---|---|
connectionSite | ConnectionSite | 启动连接已更新到的连接网站,如果移除启动连接,则为 null 。 |
弃踢回攻
Line
- 线条。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
设置页面元素的替代文本标题。
Group
元素不支持此方法。
// Set the first page element's alt text title to "new alt text title". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
参数
名称 | 类型 | 说明 |
---|---|---|
title | String | 要为替代文本标题设置的字符串。 |
弃踢回攻
Line
- 此页面元素。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
setTransform(transform)
使用提供的转换设置页面元素的转换。
更新组的转换会更改该组中页面元素的绝对转换,这可能会改变其视觉外观。
更新某个组中某个页面元素的转换只会更改该页面元素的转换,而不会影响该组或该组中其他页面元素的转换。
如需详细了解转换如何影响页面元素的视觉外观,请参阅 getTransform()
。
参数
名称 | 类型 | 说明 |
---|---|---|
transform | AffineTransform | 为此页面元素设置的转换。 |
弃踢回攻
Line
- 此元素,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations