PageElement
代表一行。
方法
內容詳盡的說明文件
alignOnPage(alignmentPosition)
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()
如果沒有連結,就會傳回 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()}`); }
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
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()
getParentPage()
getRotation()
以度數為單位,傳回元素以順時針方向從中心旋轉的角度,其中零度代表沒有旋轉。
回攻員
Number
:以度為單位的旋轉角度,介於 0 (含 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 點,請按照下列步驟操作:
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()
scaleHeight(ratio)
scaleWidth(ratio)
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()
sendToBack()
setDashStyle(style)
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)
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)
使用投影片的零起算索引,將 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 | 投影片的索引,從零開始。 |
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
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 。 |
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
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. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
參數
名稱 | 類型 | 說明 |
---|---|---|
slidePosition | SlidePosition | 相對 SlidePosition 。 |
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
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 | 網址字串。 |
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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". 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)
setTransform(transform)
使用提供的轉換,設定網頁元素的轉換。
更新群組的轉換作業會變更該群組中網頁元素的絕對轉換作業,進而變更其視覺外觀。
更新群組中頁面元素的轉換作業,只會變更該頁面元素的轉換作業,不會影響群組的轉換作業或群組中的其他頁面元素。
如要進一步瞭解轉換對網頁元素外觀的影響,請參閱 getTransform()
。
參數
名稱 | 類型 | 說明 |
---|---|---|
transform | AffineTransform | 為此網頁元素設定的轉換。 |
回攻員
Line
:這個元素用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations