このページは 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`	画像のソース URL を取得します。URL が使用できない場合、`null` を返します。
`getWidth()`	`Integer`	この画像の実際の幅をピクセル単位で返します。
`remove()`	`void`	スプレッドシートからこの画像を削除します。
`replace(blob)`	`OverGridImage`	この画像を、指定された `BlobSource` で指定された画像に置き換えます。
`replace(url)`	`OverGridImage`	この画像を、指定された URL の画像に置き換えます。
`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 - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getAltTextDescription()`

この画像の代替テキストの説明を返します。

戻る

String - 代替テキストの説明。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getAltTextTitle()`

この画像の代替テキストのタイトルを返します。

戻る

String - 代替テキストのタイトル。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getAnchorCell()`

画像が固定されているセルを返します。

戻る

Range - アンカーセル。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getAnchorCellXOffset()`

アンカーセルからの水平方向のピクセルオフセットを返します。

戻る

Integer - 水平方向のピクセルオフセット。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getAnchorCellYOffset()`

アンカーセルからの垂直方向のピクセルオフセットを返します。

戻る

Integer - 垂直方向のピクセルオフセット。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - 画像の高さ（ピクセル単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getInherentHeight()`

この画像に固有の高さをピクセル単位で返します。

戻る

Integer - 固有の高さ（ピクセル単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getInherentWidth()`

この画像に固有の高さをピクセル単位で返します。

戻る

Integer - 固有の幅（ピクセル単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getScript()`

この画像に割り当てられた関数の名前を返します。

戻る

String - 関数の名前。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - 画像が表示されるシート。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`getUrl()`

画像のソース URL を取得します。URL が使用できない場合、null を返します。画像が API を使用して URL によって挿入された場合、このメソッドは、画像挿入時に指定された URL を返します。

戻る

String - 画像の URL（利用可能な場合）。画像が利用できない場合や、画像が利用できない場合は、null を返します。ソース URL がある。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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 - 画像の幅（ピクセル単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`replace(blob)`

この画像を、指定された BlobSource で指定された画像に置き換えます。最大値最大 2 MB です。

パラメータ

名前	型	説明
`blob`	`BlobSource`	blob としての新しい画像。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`replace(url)`

この画像を、指定された URL の画像に置き換えます。

パラメータ

名前	型	説明
`url`	`String`	新しい画像の URL。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`resetSize()`

この画像を固有のサイズにリセットします。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setAltTextDescription(description)`

この画像の代替テキストの説明を設定します。

パラメータ

名前	型	説明
`description`	`String`	画像の新しい代替テキストの説明。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setAltTextTitle(title)`

この画像の代替テキストのタイトルを設定します。

パラメータ

名前	型	説明
`title`	`String`	画像の新しい代替テキストのタイトル。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setAnchorCell(cell)`

画像が固定されるセルを設定します。

パラメータ

名前	型	説明
`cell`	`Range`	新しいアンカーセル。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setAnchorCellXOffset(offset)`

アンカーセルからの水平方向のピクセルオフセットを設定します。

パラメータ

名前	型	説明
`offset`	`Integer`	新しい水平方向のピクセルオフセット。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setAnchorCellYOffset(offset)`

アンカーセルからの垂直方向のピクセルオフセットを設定します。

パラメータ

名前	型	説明
`offset`	`Integer`	新しい垂直方向のピクセルオフセット。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setHeight(height)`

この画像の実際の高さをピクセル単位で設定します。

パラメータ

名前	型	説明
`height`	`Integer`	希望する高さ（ピクセル単位）。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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

`setWidth(width)`

この画像の実際の幅をピクセル単位で設定します。

パラメータ

名前	型	説明
`width`	`Integer`	ピクセル単位の希望の幅。

戻る

OverGridImage - チェーン用のイメージ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。

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