一組 PageElement
以單一單位連結。
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
alignOnPage(alignmentPosition) | Group | 將元素與網頁上的指定對齊位置對齊。 |
bringForward() | Group | 以一個元素在網頁上向前顯示網頁元素。 |
bringToFront() | Group | 將網頁元素移到網頁中。 |
duplicate() | PageElement | 複製網頁元素。 |
getChildren() | PageElement[] | 取得群組中網頁元素的集合。 |
getConnectionSites() | ConnectionSite[] | 傳回網頁元素上的 ConnectionSite 清單;如果頁面元素沒有任何連線網站,則傳回空白清單。 |
getDescription() | String | 傳回網頁元素的替代文字說明。 |
getHeight() | Number | 取得元素的高度,也就是元素未旋轉時,元素定界框的高度。 |
getInherentHeight() | Number | 傳回元素的原點高度。 |
getInherentWidth() | Number | 傳回元素在點中的固有寬度。 |
getLeft() | Number | 傳回元素的水平位置,在元素未旋轉時從頁面左上角測量。 |
getObjectId() | String | 傳回此物件的專屬 ID。 |
getPageElementType() | PageElementType | 傳回頁面元素的類型,以 PageElementType 列舉表示。 |
getParentGroup() | Group | 傳回此頁面元素所屬的群組;如果元素不在群組中,則傳回 null 。 |
getParentPage() | Page | 傳回這個網頁元素所在的頁面。 |
getRotation() | Number | 傳回元素中心點周圍的順時針旋轉角度,0 度代表不旋轉。 |
getTitle() | String | 傳回網頁元素的替代文字標題。 |
getTop() | Number | 取得元素的垂直位置,在元素未旋轉時從頁面左上角測量。 |
getTransform() | AffineTransform | 取得網頁元素的轉換。 |
getWidth() | Number | 傳回元素在點的寬度,當元素未旋轉時,元素定界框的寬度。 |
preconcatenateTransform(transform) | Group | 預先整合提供的轉換與頁面元素的現有轉換。 |
remove() | void | 用於移除網頁元素。 |
scaleHeight(ratio) | Group | 以指定比例縮放元素高度。 |
scaleWidth(ratio) | Group | 以指定比例縮放元素的寬度。 |
select() | void | 只選取使用中簡報中的 PageElement ,並移除先前的所有選取項目。 |
select(replace) | void | 選取使用中的簡報中的 PageElement 。 |
sendBackward() | Group | 以單一元素向後傳送網頁元素。 |
sendToBack() | Group | 將網頁元素傳送至頁面背面。 |
setDescription(description) | Group | 設定網頁元素的替代文字說明。 |
setHeight(height) | Group | 設定元素的高度,以點為單位,當元素未旋轉時,該元素定界框的高度。 |
setLeft(left) | Group | 設定元素的水平位置,在元素未旋轉時從頁面左上角測量。 |
setRotation(angle) | Group | 設定元素在中心點周圍的順時針旋轉角度。 |
setTitle(title) | Group | 設定網頁元素的替代文字標題。 |
setTop(top) | Group | 設定元素的垂直位置,在元素未旋轉時從頁面左上角測量。 |
setTransform(transform) | Group | 使用提供的轉換設定頁面元素的轉換。 |
setWidth(width) | Group | 設定元素在點的寬度,當元素未旋轉時,元素定界框的寬度。 |
ungroup() | void | 取消群組元素的分組。 |
內容詳盡的說明文件
alignOnPage(alignmentPosition)
將元素與網頁上的指定對齊位置對齊。
參數
名稱 | 類型 | 說明 |
---|---|---|
alignmentPosition | AlignmentPosition | 網頁元素與網頁上對齊的位置。 |
回攻員
Group
— 此頁面元素,用於鏈結。
bringForward()
bringToFront()
duplicate()
複製網頁元素。
複製的網頁元素與原始網頁位於相同位置。
回攻員
PageElement
:此頁面元素的新副本。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getChildren()
取得群組中網頁元素的集合。群組大小下限為 2 個。
回攻員
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
getDescription()
傳回網頁元素的替代文字說明。說明會與標題結合,以便顯示和讀取替代文字。
回攻員
String
:網頁元素的替代文字說明。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
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
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
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()
取得網頁元素的轉換。
新建 Group
的初始轉換一律為身分轉換:1.0 scale 參數、0.0 Shear,並翻譯參數。
回攻員
AffineTransform
— 頁面元素的轉換。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
preconcatenateTransform(transform)
預先整合提供的轉換與頁面元素的現有轉換。
newTransform = argument * existingTransform
舉例來說,如要將網頁元素移動到左側 36:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
此外,您也可以將頁面元素的轉換取代為 setTransform(transform)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
transform | AffineTransform | 要預先串連到這個頁面元素的轉換。 |
回攻員
Group
— 此頁面元素,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
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
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()
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 | 用來設定替代文字說明的字串。 |
回攻員
Group
- 這個網頁元素。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
setLeft(left)
setRotation(angle)
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 | 用來設定替代文字標題的字串。 |
回攻員
Group
- 這個網頁元素。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
setTransform(transform)
使用提供的轉換設定頁面元素轉換。
更新群組轉換時,系統會變更該群組中頁面元素的絕對轉換,而轉換外觀可能會因此改變。
更新群組中某個頁面元素的轉換,只會變更該頁面元素的轉換;並不會影響群組或群組中其他網頁元素的轉換作業。
如要進一步瞭解轉換作業如何影響網頁元素的視覺外觀,請參閱 getTransform()
。
參數
名稱 | 類型 | 說明 |
---|---|---|
transform | AffineTransform | 為這個網頁元素設定的轉換。 |
回攻員
Group
— 用於鏈結的元素。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
ungroup()
將群組中的元素取消分組。
群組本身會遭到移除。
無法將其他群組中的群組取消分組。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations