代表試算表格線上的圖片。
方法
已淘汰的方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
| String | 取得圖片的來源網址。 |
內容詳盡的說明文件
assignScript(functionName)
將具有指定函式名稱的函式指派給這個映像檔。
參數
名稱 | 類型 | 說明 |
---|---|---|
function | String | 要指定的函式名稱。此函式必須是公開的頂層函式,且結尾不得為底線,例如 private 。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextDescription()
傳回此圖片的替代文字說明。
回攻員
String
:替代文字說明。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
傳回圖片的替代文字標題。
回攻員
String
:替代文字標題。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
getAnchorCellXOffset()
傳回錨定儲存格水平像素偏移量。
回攻員
Integer
:水平像素偏移。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellYOffset()
傳回錨定儲存格垂直方向的像素偏移量。
回攻員
Integer
:垂直像素偏移。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
以像素為單位,傳回此圖片的實際高度。
// Logs the height of all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { Logger.log(images[i].getHeight()); }
回攻員
Integer
:圖片的高度 (以像素為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentHeight()
以像素為單位,傳回此圖片的固有高度。
回攻員
Integer
:內在高度 (以像素為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentWidth()
以像素為單位,傳回此圖片的固有高度。
回攻員
Integer
:內在的寬度 (以像素為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getScript()
傳回指派給此圖片的函式名稱。
回攻員
String
:函式名稱。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
傳回這張圖片所在的工作表。
// Logs the parent sheet of all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { Logger.log(images[i].getSheet()); }
回攻員
Sheet
:圖片顯示的試算表。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
以像素為單位,傳回此圖片的實際寬度。
// Logs the width of all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { Logger.log(images[i].getWidth()); }
回攻員
Integer
:圖片的寬度 (以像素為單位)。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
從試算表中刪除這張圖片。對圖片執行任何其他作業都會導致指令碼錯誤。
// Deletes all images in a spreadsheet const images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (let i = 0; i < images.length; i++) { images[i].remove(); }
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(blob)
將這張圖片替換為由提供的 Blob
指定的圖片。支援的 blob 大小上限為 2 MB。
參數
名稱 | 類型 | 說明 |
---|---|---|
blob | Blob | 新的圖片做為 Blob。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(url)
將此圖片替換為指定網址中的圖片。
參數
名稱 | 類型 | 說明 |
---|---|---|
url | String | 新圖片的網址。 |
回攻員
Over
:此圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetSize()
將圖片重設為其固有尺寸。
回攻員
Over
:此圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
設定圖片的替代文字說明。
參數
名稱 | 類型 | 說明 |
---|---|---|
description | String | 圖片的新替代文字說明。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
設定圖片的替代文字標題。
參數
名稱 | 類型 | 說明 |
---|---|---|
title | String | 圖片的新替代文字標題。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCell(cell)
設定圖片錨定的儲存格。
參數
名稱 | 類型 | 說明 |
---|---|---|
cell | Range | 新的錨定儲存格。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellXOffset(offset)
設定錨定儲存格水平像素偏移量。
參數
名稱 | 類型 | 說明 |
---|---|---|
offset | Integer | 新的水平像素偏移。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellYOffset(offset)
設定錨定儲存格垂直像素偏移量。
參數
名稱 | 類型 | 說明 |
---|---|---|
offset | Integer | 新的垂直像素偏移。 |
回攻員
Over
:這張圖片,用於鏈結。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
以像素為單位,設定此圖片的實際高度。
參數
名稱 | 類型 | 說明 |
---|---|---|
height | Integer | 所需高度 (以像素為單位)。 |
回攻員
Over
:用於鏈結的圖片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
設定圖片的實際寬度,以像素為單位。
參數
名稱 | 類型 | 說明 |
---|---|---|
width | Integer | 所需寬度 (以像素為單位)。 |
回攻員
Over
:用於鏈結的圖片。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
已淘汰的方法
getUrl()
getUrl()
已淘汰。對於大多數新插入的圖片,系統無法提供來源網址。
取得圖片的來源網址。如果網址無法使用,就會傳回空白字串。對於大多數新插入的圖片,無論圖片插入方式為何,都無法取得來源網址。
回攻員
String
:圖片的來源網址 (如有);否則傳回空字串。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets