Class Image

圖片

代表圖片的 PageElement

方法

方法傳回類型簡短說明
alignOnPage(alignmentPosition)Image將元素對齊頁面上指定的對齊位置。
bringForward()Image將網頁元素在網頁上向前移動一個元素。
bringToFront()Image將頁面元素移至頁面前端。
duplicate()PageElement複製頁面元素。
getAs(contentType)Blob將此物件內的資料傳回為轉換為指定內容類型的 Blob。
getBlob()Blob將圖片內的資料以 blob 格式傳回。
getBorder()Border傳回圖片的 Border
getConnectionSites()ConnectionSite[]傳回頁面元素上的 ConnectionSite 清單,如果頁面元素沒有任何連線網站,則傳回空白清單。
getContentUrl()String取得圖片的網址。
getDescription()String傳回網頁元素的替代文字說明。
getHeight()Number以點為單位取得元素的高度,也就是元素未旋轉時的邊界框高度。
getInherentHeight()Number以點為單位,傳回元素的固有高度。
getInherentWidth()Number傳回元素的內在寬度 (以點為單位)。
getLeft()Number傳回元素的水平位置 (以點為單位),從元素未旋轉時的頁面左上角測量。
getLink()Link如果沒有連結,則會傳回 Linknull
getObjectId()String傳回此物件的專屬 ID。
getPageElementType()PageElementType傳回頁面元素的類型,以 PageElementType 列舉項目表示。
getParentGroup()Group傳回此頁面元素所屬的群組,如果元素不在群組中,則傳回 null
getParentPage()Page傳回這個頁面元素所在的頁面。
getParentPlaceholder()PageElement傳回預留位置的上層頁面元素。
getPlaceholderIndex()Integer傳回預留位置圖片的索引。
getPlaceholderType()PlaceholderType傳回圖片的預留位置類型,如果形狀不是預留位置,則傳回 PlaceholderType.NONE
getRotation()Number以度數為單位,傳回元素以順時針方向從中心旋轉的角度,其中零度代表沒有旋轉。
getSourceUrl()String取得圖片的來源網址 (如有)。
getTitle()String傳回網頁元素的替代文字標題。
getTop()Number取得元素的垂直位置 (以點為單位),測量時從元素未旋轉的情況下,以頁面左上角為基準。
getTransform()AffineTransform傳回網頁元素的轉換。
getWidth()Number以點為單位傳回元素的寬度,也就是元素未旋轉時的邊界框寬度。
preconcatenateTransform(transform)Image將提供的轉換先連接至網頁元素的現有轉換。
remove()void移除網頁元素。
removeLink()void移除 Link
replace(blobSource)Image將這張圖片替換為 BlobSource 物件所描述的圖片。
replace(blobSource, crop)Image將此圖片替換為 Image 物件所描述的圖片,並視需要裁剪圖片以符合大小。
replace(imageUrl)Image將這個圖片替換為從提供的網址下載的其他圖片。
replace(imageUrl, crop)Image將此圖片替換為從提供的網址下載的另一張圖片,並視需要裁剪圖片以符合大小。
scaleHeight(ratio)Image以指定的比例縮放元素的高度。
scaleWidth(ratio)Image根據指定的比例縮放元素的寬度。
select()void只選取目前簡報中的 PageElement,並移除先前的選取項目。
select(replace)void選取有效簡報中的 PageElement
sendBackward()Image將網頁元素往後移動一個元素。
sendToBack()Image將網頁元素移到頁面後方。
setDescription(description)Image設定網頁元素的替代文字說明。
setHeight(height)Image以點為單位設定元素的高度,也就是元素未旋轉時的邊界框高度。
setLeft(left)Image以點為單位設定元素的水平位置,在元素未旋轉的情況下,從頁面左上角測量。
setLinkSlide(slideIndex)Link使用投影片的零起算索引,將 Link 設為指定的 Slide
setLinkSlide(slide)LinkLink 設為指定的 Slide,連結會由指定的幻燈片 ID 設定。
setLinkSlide(slidePosition)Link使用簡報的相對位置,將 Link 設為指定的 Slide
setLinkUrl(url)LinkLink 設為指定的非空白網址字串。
setRotation(angle)Image以度為單位,設定元素以順時針方向從中心旋轉的角度。
setTitle(title)Image設定網頁元素的替代文字標題。
setTop(top)Image在元素未旋轉時,以點為單位設定元素的垂直位置,從頁面左上角開始測量。
setTransform(transform)Image使用提供的轉換,設定網頁元素的轉換。
setWidth(width)Image以點為單位設定元素的寬度,也就是元素未旋轉時的邊界框寬度。

內容詳盡的說明文件

alignOnPage(alignmentPosition)

將元素對齊頁面上指定的對齊位置。

參數

名稱類型說明
alignmentPositionAlignmentPosition這個頁面元素在頁面上對齊的位置。

回攻員

Image:這個頁面元素可用於鏈結。


bringForward()

將網頁元素在頁面上向前推一個元素。

頁面元素不得位於群組中。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

bringToFront()

將頁面元素移至頁面前端。

頁面元素不得位於群組中。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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

getAs(contentType)

將此物件內的資料傳回為轉換為指定內容類型的 Blob。這個方法會在檔案名稱中加入適當的副檔名,例如「myfile.pdf」。不過,這會假設檔案名稱中最後一個句點 (如有) 後面的部分是應取代的現有副檔名。因此,「ShoppingList.12.25.2014」會變成「ShoppingList.12.25.pdf」。

如要查看轉換的每日配額,請參閱「Google 服務的配額」。新建立的 Google Workspace 網域可能會暫時受到較嚴格的配額限制。

參數

名稱類型說明
contentTypeString要轉換的 MIME 類型。對於大多數 Blob 而言,'application/pdf' 是唯一有效的選項。如果是 BMP、GIF、JPEG 或 PNG 格式的圖片,'image/bmp''image/gif''image/jpeg''image/png' 皆可用。如果是 Google 文件,'text/markdown' 也是有效的。

回攻員

Blob:資料為 Blob。


getBlob()

將圖片內的資料以 blob 格式傳回。

回攻員

Blob:圖片資料為 Blob。


getBorder()

傳回圖片的 Border

回攻員

Border:圖片的邊框。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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

getContentUrl()

取得圖片的網址。

這個網址會標記要求者的帳戶,因此任何擁有該網址的使用者都能以原始要求者的身分存取圖片。如果簡報的共用設定有所變更,您可能會失去圖片存取權。傳回的網址會在短時間內失效。

回攻員

String

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

以點為單位取得元素的高度,也就是元素未旋轉時的邊界框高度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

回攻員

Number:頁面元素的固有高度 (以點為單位),如果頁面元素沒有高度,則為 null

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

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

如果沒有連結,就會傳回 Linknull

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

回攻員

LinkLink,如果沒有連結則為 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

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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

getParentPlaceholder()

傳回預留位置的上層頁面元素。如果圖片不是預留位置或沒有父項,則傳回 null

回攻員

PageElement:此圖片預留位置的父項網頁元素,如果此圖片不是預留位置或沒有父項,則為 null

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

getPlaceholderIndex()

傳回預留位置圖片的索引。如果同一個網頁上的兩個以上預留位置圖片屬於相同類型,則每個預留位置圖片都會有專屬的索引值。如果圖片不是預留位置,則會傳回 null

回攻員

Integer:此圖片的預留位置索引,如果圖片不是預留位置,則為 null

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

getPlaceholderType()

傳回圖片的預留位置類型,如果形狀不是預留位置,則傳回 PlaceholderType.NONE

回攻員

PlaceholderType:此圖片的預留位置類型。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

getRotation()

以度數為單位,傳回元素以順時針方向從中心旋轉的角度,其中零度代表沒有旋轉。

回攻員

Number:以度為單位的旋轉角度,介於 0 (含 0) 和 360 之間。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

getSourceUrl()

取得圖片的來源網址 (如有)。

透過網址插入圖片時,會傳回插入圖片時提供的網址。

回攻員

String:圖片網址,如果圖片沒有來源網址,則為 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

getWidth()

以點為單位傳回元素的寬度,也就是元素未旋轉時的邊界框寬度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

回攻員

Number:以點為單位的頁面元素固有寬度,如果頁面元素沒有寬度,則為 null

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

參數

名稱類型說明
transformAffineTransform要預先連接至此頁面元素轉換的轉換。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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

移除 Link

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

replace(blobSource)

將這張圖片替換為 BlobSource 物件所描述的圖片。

插入圖片時,系統會從 BlobSource 擷取圖片,並儲存一份副本供簡報使用。圖片大小不得超過 50 MB,且不得超過 2,000 萬像素,格式必須為 PNG、JPEG 或 GIF。

為了維持圖片的顯示比例,系統會根據現有圖片的大小縮放圖片,並將圖片置中。

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

參數

名稱類型說明
blobSourceBlobSource圖片資料。

回攻員

Image:更換後的 Image

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

replace(blobSource, crop)

將此圖片替換為 Image 物件所描述的圖片,並視需要裁剪圖片以符合大小。

插入圖片時,系統會從 BlobSource 擷取圖片,並儲存一份副本供簡報使用。圖片大小不得超過 50 MB,且不得超過 2,000 萬像素,格式必須為 PNG、JPEG 或 GIF。

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

參數

名稱類型說明
blobSourceBlobSource圖片資料。
cropBoolean如果為 true,系統會裁剪圖片,使其符合現有圖片的大小。否則,系統會縮放圖片並置中顯示。

回攻員

Image:更換後的 Image

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

replace(imageUrl)

將這個圖片替換為從提供的網址下載的其他圖片。

插入圖片時,系統會從網址擷取圖片一次,並儲存副本供簡報內顯示。圖片大小不得超過 50 MB,且不得超過 2,000 萬像素,格式必須為 PNG、JPEG 或 GIF。

提供的網址必須可供所有人存取,且大小不得超過 2 KB。網址本身會與圖片一併儲存,並透過 getSourceUrl() 公開。

為了維持圖片的顯示比例,系統會根據現有圖片的大小縮放圖片,並將圖片置中。

參數

名稱類型說明
imageUrlString可下載圖片的網址。

回攻員

Image:更換後的 Image

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

replace(imageUrl, crop)

將此圖片替換為從提供的網址下載的另一張圖片,並視需要裁剪圖片以符合大小。

插入圖片時,系統會從網址擷取圖片一次,並儲存副本供簡報內顯示。圖片大小不得超過 50 MB,且不得超過 2,500 萬像素,格式必須為 PNG、JPEG 或 GIF。

提供的網址大小不得超過 2 KB。

參數

名稱類型說明
imageUrlString可下載圖片的網址。
cropBoolean如果為 true,系統會裁剪圖片,使其符合現有圖片的大小。否則,系統會縮放圖片並置中顯示。

回攻員

Image:更換後的 Image

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

scaleHeight(ratio)

以指定的比例縮放元素的高度。元素的高度是指元素未旋轉時的邊界框架高度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

參數

名稱類型說明
ratioNumber這個頁面元素高度的縮放比例。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

scaleWidth(ratio)

以指定的比例縮放元素的寬度。元素的寬度是指元素未旋轉時的邊界框寬度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

參數

名稱類型說明
ratioNumber縮放此頁面元素寬度的比例。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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 參數選取網頁元素時,必須符合下列條件:

  1. PageElement 物件的父項 Page 必須是 current page selection
  2. 請勿選取多個 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);
}

參數

名稱類型說明
replaceBoolean如果為 true,則選取項目會取代先前的選取項目;否則,選取項目會新增至先前的選取項目。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

sendBackward()

將網頁元素往後移動一個元素。

頁面元素不得位於群組中。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

sendToBack()

將網頁元素移到頁面後方。

頁面元素不得位於群組中。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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());

參數

名稱類型說明
descriptionString要設定為替代文字說明的字串。

回攻員

Image:這個網頁元素。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

setHeight(height)

以點為單位設定元素的高度,也就是元素未旋轉時的邊界框高度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

參數

名稱類型說明
heightNumber要設定的這個頁面元素的新高度,以點為單位。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

setLeft(left)

以點為單位設定元素的水平位置,在元素未旋轉的情況下,從頁面左上角測量。

參數

名稱類型說明
leftNumber要設定的新水平位置,以點為單位。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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);

參數

名稱類型說明
slideIndexInteger投影片的索引,從零開始。

回攻員

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]);

參數

名稱類型說明
slideSlide要連結的 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);

參數

名稱類型說明
slidePositionSlidePosition相對 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');

參數

名稱類型說明
urlString網址字串。

回攻員

Link:已設定的 Link

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

setRotation(angle)

以度為單位,設定元素以順時針方向從中心旋轉的角度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

參數

名稱類型說明
angleNumber要設定的新順時針旋轉角度,以度為單位。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

  • 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());

參數

名稱類型說明
titleString用來設定替代文字標題的字串。

回攻員

Image:這個網頁元素。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

setTop(top)

在元素未旋轉時,以點為單位設定元素的垂直位置,從頁面左上角開始測量。

參數

名稱類型說明
topNumber要設定的新垂直位置,以點為單位。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

setTransform(transform)

使用提供的轉換,設定網頁元素的轉換。

更新群組的轉換作業會變更該群組中網頁元素的絕對轉換作業,進而變更其視覺外觀。

更新群組中頁面元素的轉換作業,只會變更該頁面元素的轉換作業,不會影響群組的轉換作業或群組中的其他頁面元素。

如要進一步瞭解轉換對網頁元素外觀的影響,請參閱 getTransform()

參數

名稱類型說明
transformAffineTransform為此網頁元素設定的轉換。

回攻員

Image:這個元素用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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

setWidth(width)

以點為單位設定元素的寬度,也就是元素未旋轉時的邊界框寬度。

這種方法不適用於所有網頁元素。如要瞭解哪些網頁元素與此方法不相容,請參閱 大小和位置限制

參數

名稱類型說明
widthNumber要設定的這個頁面元素的新寬度,以點為單位。

回攻員

Image:這個頁面元素可用於鏈結。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權:

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