Class Line

表示一条线的 PageElement。

方法

方法	返回类型	简介
`alignOnPage(alignmentPosition)`	`Line`	将元素与页面上的指定对齐位置对齐。
`bringForward()`	`Line`	将页面元素在页面上向前移动一个元素。
`bringToFront()`	`Line`	将页面元素置于页面最前面。
`duplicate()`	`PageElement`	复制页面元素。
`getConnectionSites()`	`ConnectionSite[]`	返回页面元素上的 `ConnectionSite` 列表；如果页面元素没有任何连接点，则返回空列表。
`getDashStyle()`	`DashStyle`	获取线条的 `DashStyle`。
`getDescription()`	`String`	返回网页元素的替代文本说明。
`getEnd()`	`Point`	返回线条的终点（从页面左上角开始测量）。
`getEndArrow()`	`ArrowStyle`	获取线条末尾箭头的 `ArrowStyle`。
`getEndConnection()`	`ConnectionSite\|null`	返回行尾的连接，如果没有连接，则返回 `null`。
`getHeight()`	`Number\|null`	获取元素的高度（以磅为单位），即元素未旋转时其边界框的高度。
`getInherentHeight()`	`Number\|null`	返回元素的固有高度（以点为单位）。
`getInherentWidth()`	`Number\|null`	返回元素的固有宽度（以点为单位）。
`getLeft()`	`Number`	返回元素在页面中的水平位置（以点为单位），当元素未旋转时，该位置从页面的左上角开始测量。
`getLineCategory()`	`LineCategory`	获取线条的 `LineCategory`。
`getLineFill()`	`LineFill`	获取线条的 `LineFill`。
`getLineType()`	`LineType`	获取线条的 `LineType`。
`getLink()`	`Link\|null`	如果没有链接，则返回 `Link` 或 `null`。
`getObjectId()`	`String`	返回相应对象的唯一 ID。
`getPageElementType()`	`PageElementType`	返回网页元素的类型，以 `PageElementType` 枚举表示。
`getParentGroup()`	`Group\|null`	返回相应页面元素所属的组；如果该元素不属于任何组，则返回 `null`。
`getParentPage()`	`Page`	返回相应页面元素所在的页面。
`getRotation()`	`Number`	返回元素围绕其中心顺时针旋转的角度（以度为单位），其中零度表示不旋转。
`getStart()`	`Point`	返回线条的起点，从网页的左上角开始测量。
`getStartArrow()`	`ArrowStyle`	获取行开头箭头的 `ArrowStyle`。
`getStartConnection()`	`ConnectionSite\|null`	返回行开头的连接，如果没有连接，则返回 `null`。
`getTitle()`	`String`	返回网页元素的替代文本标题。
`getTop()`	`Number`	获取元素的垂直位置（以点为单位），该位置是从页面左上角测量的，前提是元素未旋转。
`getTransform()`	`AffineTransform`	返回页面元素的转换。
`getWeight()`	`Number`	返回线条的粗细（以磅为单位）。
`getWidth()`	`Number\|null`	返回元素的宽度（以点为单位），即元素未旋转时其边界框的宽度。
`isConnector()`	`Boolean`	如果相应线路是连接器，则返回 `true`；否则返回 `false`。
`preconcatenateTransform(transform)`	`Line`	将提供的转换预串联到页面元素的现有转换。
`remove()`	`void`	移除页面元素。
`removeLink()`	`void`	移除 `Link`。
`reroute()`	`Line`	将线条的起点和终点重新路由到所连接页面元素上最近的两个连接点。
`scaleHeight(ratio)`	`Line`	按指定比例缩放元素的高度。
`scaleWidth(ratio)`	`Line`	按指定比例缩放元素的宽度。
`select()`	`void`	仅选择当前演示中的 `PageElement`，并移除任何之前的选择。
`select(replace)`	`void`	选择当前演示文稿中的 `PageElement`。
`sendBackward()`	`Line`	将页面元素在页面上向后移动一个元素。
`sendToBack()`	`Line`	将页面元素发送到页面后方。
`setDashStyle(style)`	`Line`	设置线条的 `DashStyle`。
`setDescription(description)`	`Line`	设置网页元素的替代文本说明。
`setEnd(left, top)`	`Line`	设置线条端点的位置。
`setEnd(point)`	`Line`	设置线条端点的位置。
`setEndArrow(style)`	`Line`	设置位于行末尾的箭头的 `ArrowStyle`。
`setEndConnection(connectionSite)`	`Line`	设置线条末尾的连接。
`setHeight(height)`	`Line`	以磅为单位设置元素的高度，即元素未旋转时元素边界框的高度。
`setLeft(left)`	`Line`	设置元素在页面中的水平位置（以点为单位），从页面左上角开始测量（当元素未旋转时）。
`setLineCategory(lineCategory)`	`Line`	设置线条的 `LineCategory`。
`setLinkSlide(slideIndex)`	`Link`	使用幻灯片的从零开始的索引，将 `Link` 设置为给定的 `Slide`。
`setLinkSlide(slide)`	`Link`	将 `Link` 设置为给定的 `Slide`，链接由给定的幻灯片 ID 设置。
`setLinkSlide(slidePosition)`	`Link`	使用幻灯片的相对位置，将 `Link` 设置为给定的 `Slide`。
`setLinkUrl(url)`	`Link`	将 `Link` 设置为给定的非空网址字符串。
`setRotation(angle)`	`Line`	设置元素围绕其中心顺时针旋转的角度（以度为单位）。
`setStart(left, top)`	`Line`	设置线条起点的坐标。
`setStart(point)`	`Line`	设置线条起点的坐标。
`setStartArrow(style)`	`Line`	设置位于行开头的箭头的 `ArrowStyle`。
`setStartConnection(connectionSite)`	`Line`	将连接设置在行开头。
`setTitle(title)`	`Line`	设置网页元素的替代文本标题。
`setTop(top)`	`Line`	设置元素的垂直位置（以点为单位），当元素未旋转时，该位置从页面的左上角开始测量。
`setTransform(transform)`	`Line`	使用提供的转换设置页面元素的转换。
`setWeight(points)`	`Line`	设置线条的粗细（以磅为单位）。
`setWidth(width)`	`Line`	以磅为单位设置元素的宽度，即元素未旋转时，元素边界框的宽度。

详细文档

`alignOnPage(alignmentPosition)`

将元素与页面上的指定对齐位置对齐。

参数

名称	类型	说明
`alignmentPosition`	`AlignmentPosition`	相应页面元素在页面上的对齐位置。

Line - 此页面元素，用于链式调用。

`bringForward()`

将页面元素在页面上向前移动一个元素。

页面元素不得位于群组中。

Line - 此页面元素，用于链式调用。

授权

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

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

`bringToFront()`

将页面元素置于页面最前面。

页面元素不得位于群组中。

Line - 此页面元素，用于链式调用。

授权

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

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

`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()`

获取线条的 DashStyle。

DashStyle - 用于此线条的虚线样式。

授权

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

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

`getDescription()`

返回网页元素的替代文本说明。说明与标题结合使用，以显示和朗读替代文本。

String - 页面元素的替代文本说明。

授权

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

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

`getEnd()`

返回线条的终点（从页面左上角开始测量）。

Point - 线条的终点。

授权

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

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

`getEndArrow()`

获取线条末尾箭头的 ArrowStyle。

ArrowStyle - 此线条末尾的箭头样式。

授权

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

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

`getEndConnection()`

返回行尾的连接，如果没有连接，则返回 null。

ConnectionSite|null - 线条末端的连接。

授权

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

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

`getHeight()`

获取元素的高度（以磅为单位），即元素未旋转时其边界框的高度。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

Number|null - 页面元素的固有高度（以点为单位），如果页面元素没有高度，则为 null。

授权

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

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

`getInherentHeight()`

返回元素的固有高度（以点为单位）。

页面元素的转换是相对于其固有大小而言的。使用固有大小并结合元素的转换来确定元素的最终视觉外观。

Number|null - 页面元素的固有高度（以点为单位），如果页面元素没有高度，则为 null。

授权

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

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

`getInherentWidth()`

返回元素的固有宽度（以点为单位）。

页面元素的转换是相对于其固有大小而言的。使用固有大小并结合元素的转换来确定元素的最终视觉外观。

Number|null - 页面元素的固有宽度（以点为单位），如果页面元素没有宽度，则为 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()`

获取线条的 LineFill。

LineFill - 相应线的填充设置。

授权

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

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

`getLineType()`

获取线条的 LineType。

LineType - 相应行的类型。

授权

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

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

`getLink()`

如果不存在链接，则返回 Link 或 null。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Link|null - 如果没有链接，则为 Link 或 null。

授权

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

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

`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()`

返回相应页面元素所属的组；如果该元素不属于任何组，则返回 null。

Group|null - 此页面元素所属的群组，或 null。

授权

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

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

`getParentPage()`

返回相应页面元素所在的页面。

Page - 相应元素所在的网页。

授权

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

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

`getRotation()`

返回元素围绕其中心顺时针旋转的角度（以度为单位），其中零度表示不旋转。

Number - 旋转角度（以度为单位），介于 0（含）和 360（不含）之间。

授权

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

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

`getStart()`

返回线条的起点，从网页的左上角开始测量。

Point - 线条的起点。

授权

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

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

`getStartArrow()`

获取行开头箭头的 ArrowStyle。

ArrowStyle - 此行开头箭头的样式。

授权

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

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

`getStartConnection()`

返回行开头的连接，如果没有连接，则返回 null。

ConnectionSite|null - 线路开头的连接。

授权

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

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()`

返回元素的宽度（以点为单位），即元素未旋转时其边界框的宽度。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

Number|null - 页面元素的固有宽度（以点为单位），如果页面元素没有宽度，则为 null。

授权

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

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

`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 点，请执行以下操作：

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
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。

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`reroute()`

将线条的起点和终点重新路由到所连接页面元素上最近的两个连接点。线条的起点和终点必须连接到不同的页面元素。

Line - 线路。

授权

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

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

`scaleHeight(ratio)`

按指定比率缩放元素的高度。当元素未旋转时，元素的高度是其边界框的高度。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

参数

名称	类型	说明
`ratio`	`Number`	用于缩放相应网页元素高度的比率。

Line - 此页面元素，用于链式调用。

授权

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

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

`scaleWidth(ratio)`

按指定比例缩放元素的宽度。元素的宽度是指元素未旋转时其边界框的宽度。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

参数

名称	类型	说明
`ratio`	`Number`	用于缩放相应网页元素宽度的比率。

Line - 此页面元素，用于链式调用。

授权

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

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

`select()`

仅选择当前演示中的 PageElement，并移除任何之前的选择。这与使用 true 调用 select(replace) 相同。

脚本只能访问运行该脚本的用户的选择内容，并且只有当脚本绑定到演示文稿时才能访问。

这会将 PageElement 的父 Page 设置为 current page selection。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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，然后选择该页面中的页面元素。

const 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.
const pageElements = slide.getPageElements();
for (let 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()`

将页面元素在页面上向后移动一个元素。

页面元素不得位于群组中。

Line - 此页面元素，用于链式调用。

授权

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

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

`sendToBack()`

将页面元素发送到页面后方。

页面元素不得位于群组中。

Line - 此页面元素，用于链式调用。

授权

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

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

`setDashStyle(style)`

设置线条的 DashStyle。

参数

名称	类型	说明
`style`	`DashStyle`	要为此线条设置的虚线样式。

Line - 此行，用于链式调用。

授权

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

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

`setDescription(description)`

设置网页元素的替代文本说明。

该方法不支持 Group 元素。

// Set the first page element's alt text description to "new alt text
// description".
const 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)`

设置线条终点的位置。

位置更改后，线路路径可能会调整。

参数

名称	类型	说明
`left`	`Number`	线条终点的水平位置，以点为单位，从页面左上角开始测量。
`top`	`Number`	线条终点的垂直位置，以点为单位从页面左上角开始测量。

Line - 此行，用于链式调用。

授权

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

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

`setEnd(point)`

设置线条终点的位置。

位置更改后，线路路径可能会调整。

参数

名称	类型	说明
`point`	`Point`	线段的终点，其位置是从页面左上角测量的。

Line - 此行，用于链式调用。

授权

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

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

`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)`

以磅为单位设置元素的高度，即元素在未旋转时其边界框的高度。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

参数

名称	类型	说明
`height`	`Number`	要设置的相应页面元素的新高度（以点为单位）。

Line - 此页面元素，用于链式调用。

授权

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

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

`setLeft(left)`

设置元素在页面中的水平位置（以点为单位），从页面左上角开始测量（当元素未旋转时）。

参数

名称	类型	说明
`left`	`Number`	要设置的新水平位置（以点为单位）。

Line - 此页面元素，用于链式调用。

授权

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

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

`setLineCategory(lineCategory)`

设置线条的 LineCategory。

您只能在 connectors 上设置类别。更改连接器的类别后，系统可能会重新路由该连接器。

参数

名称	类型	说明
`lineCategory`	`LineCategory`	要设置的线条类别。

Line - 线路。

授权

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

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

`setLinkSlide(slideIndex)`

使用幻灯片的从零开始的索引，将 Link 设置为给定的 Slide。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

参数

名称	类型	说明
`slideIndex`	`Integer`	幻灯片的索引（从零开始）。

Link - 已设置的 Link。

授权

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

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

`setLinkSlide(slide)`

将 Link 设置为给定的 Slide，链接由给定的幻灯片 ID 设置。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

参数

名称	类型	说明
`slide`	`Slide`	要关联的 `Slide`。

Link - 已设置的 Link。

授权

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

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

`setLinkSlide(slidePosition)`

使用幻灯片的相对位置，将 Link 设置为给定的 Slide。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

参数

名称	类型	说明
`slidePosition`	`SlidePosition`	相对 `SlidePosition`。

Link - 已设置的 Link。

授权

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

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

`setLinkUrl(url)`

将 Link 设置为给定的非空网址字符串。

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

参数

名称	类型	说明
`url`	`String`	网址字符串。

Link - 已设置的 Link。

授权

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

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

`setRotation(angle)`

设置元素围绕其中心顺时针旋转的角度（以度为单位）。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

参数

名称	类型	说明
`angle`	`Number`	要设置的新顺时针旋转角度（以度为单位）。

Line - 此页面元素，用于链式调用。

授权

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

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

`setStart(left, top)`

设置线条起点的坐标。

位置更改后，线路路径可能会调整。

参数

名称	类型	说明
`left`	`Number`	线条起点的水平位置，以点为单位，从页面左上角开始测量。
`top`	`Number`	线条起点的垂直位置，以点为单位从页面左上角开始测量。

Line - 此行，用于链式调用。

授权

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

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

`setStart(point)`

设置线条起点的坐标。

位置更改后，线路路径可能会调整。

参数

名称	类型	说明
`point`	`Point`	线条的起点，其位置是从页面左上角测量的。

Line - 此行，用于链式调用。

授权

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

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

`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".
const 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)`

设置元素的垂直位置（以点为单位），当元素未旋转时，该位置从页面的左上角开始测量。

参数

名称	类型	说明
`top`	`Number`	要设置的新垂直位置（以点为单位）。

Line - 此页面元素，用于链式调用。

授权

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

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

`setTransform(transform)`

使用提供的转换设置页面元素的转换。

更新组的转换会更改该组中页面元素的绝对转换，从而改变其视觉外观。

更新组中某个页面元素的转换只会更改该页面元素的转换，而不会影响组或组中其他页面元素的转换。

如需详细了解转换如何影响网页元素的视觉外观，请参阅 getTransform()。

参数

名称	类型	说明
`transform`	`AffineTransform`	为相应页面元素设置的转换。

Line - 此元素，用于链式调用。

授权

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

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

`setWeight(points)`

设置线条的粗细（以磅为单位）。

参数

名称	类型	说明
`points`	`Number`	线条的新粗细（以磅为单位）。

Line - 此行，用于链式调用。

授权

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

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

`setWidth(width)`

以磅为单位设置元素的宽度，即元素在未旋转时其边界框的宽度。

此方法不适用于所有网页元素。如需了解哪些页面元素与此方法不兼容，请参阅大小调整和定位限制。

参数

名称	类型	说明
`width`	`Number`	要设置的相应页面元素的新宽度（以磅为单位）。

Line - 此页面元素，用于链式调用。

授权

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

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

Class Line 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

方法

详细文档

alignOnPage(alignmentPosition)

参数

返回

bringForward()

返回

授权

bringToFront()

返回

授权

duplicate()

返回

授权

getConnectionSites()

返回

授权

getDashStyle()

返回

授权

getDescription()

返回

授权

getEnd()

返回

授权

getEndArrow()

返回

授权

getEndConnection()

返回

授权

getHeight()

返回

授权

getInherentHeight()

返回

授权

getInherentWidth()

返回

授权

getLeft()

返回

授权

getLineCategory()

返回

授权

getLineFill()

返回

授权

getLineType()

返回

授权

getLink()

返回

授权

getObjectId()

返回

授权

getPageElementType()

返回

授权

getParentGroup()

返回

授权

getParentPage()

返回

授权

getRotation()

返回

授权

getStart()

返回

授权

getStartArrow()

返回

授权

getStartConnection()

返回

Class Line

`alignOnPage(alignmentPosition)`

`bringForward()`

`bringToFront()`

`duplicate()`

`getConnectionSites()`

`getDashStyle()`

`getDescription()`

`getEnd()`

`getEndArrow()`

`getEndConnection()`

`getHeight()`

`getInherentHeight()`

`getInherentWidth()`

`getLeft()`

`getLineCategory()`

`getLineFill()`

`getLineType()`

`getLink()`

`getObjectId()`

`getPageElementType()`

`getParentGroup()`

`getParentPage()`

`getRotation()`

`getStart()`

`getStartArrow()`

`getStartConnection()`

`getTitle()`

`getTop()`

`getTransform()`

`getWeight()`

`getWidth()`

`isConnector()`

`preconcatenateTransform(transform)`

`remove()`

`removeLink()`

`reroute()`

`scaleHeight(ratio)`

`scaleWidth(ratio)`

`select()`

`select(replace)`

`sendBackward()`

`sendToBack()`

`setDashStyle(style)`

`setDescription(description)`

`setEnd(left, top)`

`setEnd(point)`

`setEndArrow(style)`

`setEndConnection(connectionSite)`