スプレッドシートのグリッド上の画像を表します。
メソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
assign | Over | 指定された関数名の関数をこのイメージに割り当てます。 |
get | String | この画像の代替テキストの説明を返します。 |
get | String | この画像の代替テキストのタイトルを返します。 |
get | Range | 画像が固定されているセルを返します。 |
get | Integer | アンカーセルからの水平方向のピクセル オフセットを返します。 |
get | Integer | アンカーセルからの垂直方向のピクセル オフセットを返します。 |
get | Integer | この画像の実際の高さ(ピクセル単位)を返します。 |
get | Integer | この画像の本質的な高さ(ピクセル単位)を返します。 |
get | Integer | この画像の本質的な高さ(ピクセル単位)を返します。 |
get | String | このイメージに割り当てられた関数の名前を返します。 |
get | Sheet | この画像が表示されているシートを返します。 |
get | String | 画像のソース URL を取得します。URL が使用できない場合は null を返します。 |
get | Integer | この画像の実際の幅をピクセル単位で返します。 |
remove() | void | この画像をスプレッドシートから削除します。 |
replace(blob) | Over | この画像を、指定された Blob で指定された画像に置き換えます。 |
replace(url) | Over | この画像を、指定した URL の画像に置き換えます。 |
reset | Over | この画像を元のサイズにリセットします。 |
set | Over | この画像の代替テキストの説明を設定します。 |
set | Over | この画像の代替テキストのタイトルを設定します。 |
set | Over | 画像を固定するセルを設定します。 |
set | Over | アンカーセルからの水平方向のピクセル オフセットを設定します。 |
set | Over | アンカーセルからの垂直方向のピクセル オフセットを設定します。 |
set | Over | この画像の実際の高さをピクセル単位で設定します。 |
set | Over | この画像の実際の幅をピクセル単位で設定します。 |
詳細なドキュメント
assign Script(functionName)
指定された関数名の関数をこのイメージに割り当てます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
function | String | 指定する関数の名前。これは、private のようにアンダースコアで終わる関数ではなく、パブリックなトップレベル関数である必要があります。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Alt Text Description()
この画像の代替テキストの説明を返します。
戻る
String
- 代替テキストの説明。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Alt Text Title()
この画像の代替テキストのタイトルを返します。
戻る
String
- 代替テキストのタイトル。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Anchor Cell()
get Anchor Cell XOffset()
アンカーセルからの水平方向のピクセル オフセットを返します。
戻る
Integer
- 水平方向のピクセル オフセット。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Anchor Cell YOffset()
アンカーセルからの垂直方向のピクセル オフセットを返します。
戻る
Integer
- 垂直方向のピクセル オフセット。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Height()
この画像の実際の高さをピクセル単位で返します。
// 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
get Inherent Height()
この画像の本質的な高さ(ピクセル単位)を返します。
戻る
Integer
- 固有の高さ(ピクセル単位)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Inherent Width()
この画像の本質的な高さ(ピクセル単位)を返します。
戻る
Integer
- 固有の幅(ピクセル単位)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Script()
このイメージに割り当てられた関数の名前を返します。
戻る
String
- 関数の名前。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Sheet()
この画像が表示されているシートを返します。
// 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
get Url()
画像のソース URL を取得します。URL が使用できない場合は null
を返します。API を使用して URL で画像が挿入された場合、このメソッドは画像の挿入時に指定された URL を返します。
戻る
String
- 画像の URL(利用可能な場合)。画像が利用できない、またはソース URL がない場合は null
を返します。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Width()
この画像の実際の幅をピクセル単位で返します。
// 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)
この画像を、指定された Blob
で指定された画像に置き換えます。サポートされている blob の最大サイズは 2 MB です。
パラメータ
名前 | 型 | 説明 |
---|---|---|
blob | Blob | 新しいイメージ(Blob)。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(url)
この画像を、指定した URL の画像に置き換えます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
url | String | 新しい画像の URL。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
reset Size()
この画像を元のサイズにリセットします。
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Alt Text Description(description)
この画像の代替テキストの説明を設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
description | String | 画像の新しい代替テキストの説明。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Alt Text Title(title)
この画像の代替テキストのタイトルを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
title | String | 画像の新しい代替テキストのタイトル。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Anchor Cell(cell)
画像を固定するセルを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
cell | Range | 新しいアンカーセル。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Anchor Cell XOffset(offset)
アンカーセルからの水平方向のピクセル オフセットを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
offset | Integer | 新しい水平方向のピクセル オフセット。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Anchor Cell YOffset(offset)
アンカーセルからの垂直方向のピクセル オフセットを設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
offset | Integer | 新しい垂直ピクセル オフセット。 |
戻る
Over
- チェーン用のこの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Height(height)
この画像の実際の高さをピクセル単位で設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
height | Integer | 希望する高さ(ピクセル単位)。 |
戻る
Over
- チェーン用の画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Width(width)
この画像の実際の幅をピクセル単位で設定します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
width | Integer | 希望する幅(ピクセル単位)。 |
戻る
Over
- チェーン用の画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets