本頁面由 Cloud Translation API 翻譯而成。

Class OverGridImage

代表試算表中格線的圖片。

方法

方法	傳回類型	簡短說明
`assignScript(functionName)`	`OverGridImage`	將含有指定函式名稱的函式指派給這張圖片。
`getAltTextDescription()`	`String`	傳回此圖片的替代文字說明。
`getAltTextTitle()`	`String`	傳回此圖片的替代文字標題。
`getAnchorCell()`	`Range`	傳回錨定圖片的儲存格。
`getAnchorCellXOffset()`	`Integer`	傳回錨定儲存格的水平像素偏移。
`getAnchorCellYOffset()`	`Integer`	傳回錨定儲存格的垂直像素偏移。
`getHeight()`	`Integer`	傳回這張圖片的實際高度 (以像素為單位)。
`getInherentHeight()`	`Integer`	傳回此圖片的固有高度 (以像素為單位)。
`getInherentWidth()`	`Integer`	傳回此圖片的固有高度 (以像素為單位)。
`getScript()`	`String`	傳回指派給此圖片的函式名稱。
`getSheet()`	`Sheet`	傳回此圖片所在的工作表。
`getUrl()`	`String`	取得圖片的來源網址。如果網址無法使用，則會傳回 `null`。
`getWidth()`	`Integer`	傳回這張圖片的實際寬度 (以像素為單位)。
`remove()`	`void`	從試算表中刪除這張圖片。
`replace(blob)`	`OverGridImage`	將這張圖片取代為提供的 `BlobSource` 指定的圖片。
`replace(url)`	`OverGridImage`	將這張圖片取代為指定網址的圖片。
`resetSize()`	`OverGridImage`	將這張圖片重設為原始尺寸。
`setAltTextDescription(description)`	`OverGridImage`	設定這張圖片的替代文字說明。
`setAltTextTitle(title)`	`OverGridImage`	設定這張圖片的替代文字標題。
`setAnchorCell(cell)`	`OverGridImage`	設定錨定圖片的儲存格。
`setAnchorCellXOffset(offset)`	`OverGridImage`	設定與錨定儲存格之間的水平像素偏移。
`setAnchorCellYOffset(offset)`	`OverGridImage`	設定錨定儲存格的垂直像素偏移。
`setHeight(height)`	`OverGridImage`	設定這張圖片的實際高度 (以像素為單位)。
`setWidth(width)`	`OverGridImage`	設定這張圖片的實際寬度 (以像素為單位)。

內容詳盡的說明文件

`assignScript(functionName)`

將含有指定函式名稱的函式指派給這張圖片。

參數

名稱	類型	說明
`functionName`	`String`	指定的函式名稱。必須是公開的頂層函式，並非以底線結尾，例如 `privateFunction_`。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

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

傳回錨定圖片的儲存格。

回攻員

Range：錨定儲存格。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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

`getUrl()`

取得圖片的來源網址。如果網址無法使用，則會傳回 null。如果圖片由網址插入，這個方法會傳回圖片插入時提供的網址。

回攻員

String：圖片網址 (如有)；如果圖片無法使用或無法使用，則會傳回 null 來源網址

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getWidth()`

傳回這張圖片的實際寬度 (以像素為單位)。

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`replace(blob)`

將這張圖片取代為提供的 BlobSource 指定的圖片。最大值支援的 blob 大小為 2 MB。

參數

名稱	類型	說明
`blob`	`BlobSource`	新圖片做為 Blob。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`replace(url)`

將這張圖片取代為指定網址的圖片。

參數

名稱	類型	說明
`url`	`String`	新圖片的網址。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`resetSize()`

將這張圖片重設為原始尺寸。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAltTextDescription(description)`

設定這張圖片的替代文字說明。

參數

名稱	類型	說明
`description`	`String`	圖片的新替代文字說明。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAltTextTitle(title)`

設定這張圖片的替代文字標題。

參數

名稱	類型	說明
`title`	`String`	圖片的新替代文字標題。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAnchorCell(cell)`

設定錨定圖片的儲存格。

參數

名稱	類型	說明
`cell`	`Range`	新的錨定儲存格。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAnchorCellXOffset(offset)`

設定與錨定儲存格之間的水平像素偏移。

參數

名稱	類型	說明
`offset`	`Integer`	新的水平像素偏移。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setAnchorCellYOffset(offset)`

設定錨定儲存格的垂直像素偏移。

參數

名稱	類型	說明
`offset`	`Integer`	新垂直像素偏移。

回攻員

OverGridImage：這張圖片用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeight(height)`

設定這張圖片的實際高度 (以像素為單位)。

參數

名稱	類型	說明
`height`	`Integer`	所需的高度 (以像素為單位)。

回攻員

OverGridImage：用於鏈結的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setWidth(width)`

設定這張圖片的實際寬度 (以像素為單位)。

參數

名稱	類型	說明
`width`	`Integer`	所需的寬度 (以像素為單位)。

回攻員

OverGridImage：用於鏈結的圖片。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets