Page
代表一行。
方法
內容詳盡的說明文件
align On Page(alignmentPosition)
bring Forward()
bring To Front()
duplicate()
複製頁面元素。
重複的網頁元素會放在與原始元素相同的網頁位置。
回攻員
Page
:這個網頁元素的新重複項目。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Connection Sites()
傳回頁面元素上的 Connection
清單,如果頁面元素沒有任何連線網站,則傳回空白清單。
回攻員
Connection
:連線網站清單。如果這個元素沒有連線網站,清單可能會是空白。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Dash Style()
get Description()
傳回網頁元素的替代文字說明。說明會與標題結合,用於顯示及朗讀替代文字。
回攻員
String
:網頁元素的替代文字說明。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get End()
get End Arrow()
取得線條結尾處箭頭的 Arrow
。
回攻員
Arrow
:這行結尾的箭頭樣式。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get End Connection()
傳回行結尾的連線,如果沒有連線,則傳回 null
。
回攻員
Connection
:線條末端的連線。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Height()
get Inherent Height()
傳回元素的內在高度 (以點為單位)。
頁面元素的轉換作業會以其固有大小為依據。使用內在大小搭配元素的轉換,判斷元素的最終視覺外觀。
回攻員
Number
:頁面元素的固有高度 (以點為單位),如果頁面元素沒有高度,則為 null
。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Width()
以點為單位,傳回元素的固有寬度。
頁面元素的轉換作業會以其固有大小為依據。使用內在大小搭配元素的轉換,判斷元素的最終視覺外觀。
回攻員
Number
:以點為單位的頁面元素固有寬度,如果頁面元素沒有寬度,則為 null
。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Left()
傳回元素的水平位置 (以點為單位),從元素未旋轉時的頁面左上角測量。
回攻員
Number
:此元素在頁面左上角的水平位置。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Line Category()
取得線條的 Line
。
回攻員
Line
:線條類別。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Line Fill()
get Line Type()
get Link()
如果沒有連結,就會傳回 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
get Object Id()
傳回此物件的專屬 ID。網頁和網頁元素使用的物件 ID 會共用相同的命名空間。
回攻員
String
:這個物件的專屬 ID。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element Type()
傳回頁面元素的類型,以 Page
列舉項目表示。
回攻員
Page
:頁面元素的類型。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Parent Group()
get Parent Page()
get Rotation()
以度數為單位,傳回元素以順時針方向從中心旋轉的角度,其中零度代表沒有旋轉。
回攻員
Number
:以度為單位的旋轉角度,介於 0 (含 0) 和 360 之間。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Start()
get Start Arrow()
取得行首箭頭的 Arrow
。
回攻員
Arrow
:這行開頭的箭頭樣式。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Start Connection()
傳回該行開頭的連結,如果沒有連結,則傳回 null
。
回攻員
Connection
:線條開頭處的連線。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Title()
傳回網頁元素的替代文字標題。標題會與說明合併,用於顯示及朗讀替代文字。
回攻員
String
:網頁元素的替代文字標題。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Top()
取得元素的垂直位置 (以點為單位),測量時從元素未旋轉的情況下,以頁面左上角為基準。
回攻員
Number
:從頁面左上角算起,此元素的垂直位置 (以點為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Transform()
傳回網頁元素的轉換。
網頁元素的視覺外觀取決於其絕對轉換。如要計算絕對轉換,請預先將網頁元素的轉換與所有父群組的轉換連接起來。如果網頁元素不在群組中,其絕對轉換會與這個欄位中的值相同。
回攻員
Affine
:網頁元素的轉換。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Weight()
傳回線條的厚度 (以點為單位)。
回攻員
Number
:以點為單位的線條粗細。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Width()
is Connector()
如果線條是連接線,就會傳回 true
;如果不是,則會傳回 false
。
連接器是一種線條,用於連結適用網頁元素上的連線網站。連接器的每個端點最多只能連接至一個連接點。
回攻員
Boolean
:如果是連接線,則為 True
;如果不是,則為 false
。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenate Transform(transform)
將提供的轉換先連接至網頁元素的現有轉換。
newTransform = argument * existingTransform;
舉例來說,如要將頁面元素向左移動 36 點,請按照下列步驟操作:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
您也可以將頁面元素的轉換效果替換為 set
。
參數
名稱 | 類型 | 說明 |
---|---|---|
transform | Affine | 要預先連接至此頁面元素轉換的轉換。 |
回攻員
Line
:這個頁面元素可用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
移除網頁元素。
如果在移除作業後,Group
只包含一個或沒有任何網頁元素,群組本身也會一併移除。
如果在母版或版面配置中移除預留位置 Page
,所有空白繼承預留位置也會一併移除。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Link()
移除 Link
。
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
reroute()
scale Height(ratio)
scale Width(ratio)
select()
只選取目前活動簡報中的 Page
,並移除先前的選取項目。這與使用 true
呼叫 select(replace)
相同。
指令碼只能存取執行指令碼的使用者所選取的項目,且只有在指令碼繫結至簡報時才能存取。
這會將 Page
的父項 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)
選取有效簡報中的 Page
。
指令碼只能存取執行指令碼的使用者所選取的項目,且只有在指令碼繫結至簡報時才能存取。
將 true
傳遞至此方法,只選取 Page
並移除先前的任何選取項目。這也會將 Page
的父項 Page
設為 current page selection
。
傳遞 false
即可選取多個 Page
物件。Page
物件必須位於相同的 Page
中。
使用 false
參數選取網頁元素時,必須符合下列條件:
Page
物件的父項Element 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
send Backward()
send To Back()
set Dash Style(style)
set Description(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
set End(left, top)
set End(point)
set End Arrow(style)
設定線條結尾箭頭的 Arrow
。
參數
名稱 | 類型 | 說明 |
---|---|---|
style | Arrow | 要設定的樣式。 |
回攻員
Line
:這個行用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set End Connection(connectionSite)
設定行尾的連線。這項功能會將線條的另一端移至指定的連接點,而另一端則保持不變。
參數
名稱 | 類型 | 說明 |
---|---|---|
connection | Connection | 更新端連線的連線網站,如果移除端連線,則為 null 。 |
回攻員
Line
:線條。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Height(height)
set Left(left)
set Line Category(lineCategory)
設定線條的 Line
。
您只能在 connectors
上設定類別。變更連接器類別後,可能會重新路由連接器。
參數
名稱 | 類型 | 說明 |
---|---|---|
line | Line | 要設定的線條類別。 |
回攻員
Line
:線條。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(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);
參數
名稱 | 類型 | 說明 |
---|---|---|
slide | Integer | 投影片的索引,從零開始。 |
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(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
set Link Slide(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);
參數
名稱 | 類型 | 說明 |
---|---|---|
slide | Slide | 相對 Slide 。 |
回攻員
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Url(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
set Rotation(angle)
set Start(left, top)
set Start(point)
set Start Arrow(style)
設定線條開頭箭頭的 Arrow
。
參數
名稱 | 類型 | 說明 |
---|---|---|
style | Arrow | 要設定的新箭頭樣式。 |
回攻員
Line
:這個行用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Start Connection(connectionSite)
在行首設定連線。它會將線條的起點移至指定的連線位置,同時保留另一端。
參數
名稱 | 類型 | 說明 |
---|---|---|
connection | Connection | 更新開始連線的連線網站,或移除開始連線時的 null 。 |
回攻員
Line
:線條。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Title(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
set Top(top)
set Transform(transform)
使用提供的轉換,設定網頁元素的轉換。
更新群組的轉換作業會變更該群組中網頁元素的絕對轉換作業,進而變更其視覺外觀。
更新群組中頁面元素的轉換作業,只會變更該頁面元素的轉換作業,不會影響群組的轉換作業或群組中的其他頁面元素。
如要進一步瞭解轉換對網頁元素外觀的影響,請參閱 get
。
參數
名稱 | 類型 | 說明 |
---|---|---|
transform | Affine | 為此網頁元素設定的轉換。 |
回攻員
Line
:這個元素用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations