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

將指定 Slide 的 Link 設為指定投影片 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)`