此页面由 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。如果图片使用 API 通过网址插入，此方法会返回在插入图片期间提供的网址。

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 大小为 2MB。

参数

名称	类型	说明
`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