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如果沒有連結，則會傳回 Link 或 null。
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)Link將 Link 設為指定的 Slide，連結會由指定的幻燈片 ID 設定。
setLinkSlide(slidePosition)Link使用簡報的相對位置，將 Link 設為指定的 Slide。
setLinkUrl(url)Link將 Link 設為指定的非空白網址字串。
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

如果沒有連結，就會傳回 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：如果沒有連結，則為 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。

授權

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

  • 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,500 萬像素，格式必須為 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