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)

指定された関数名の関数をこのイメージに割り当てます。

パラメータ

名前説明
functionNameString指定する関数の名前。これは、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(利用可能な場合)。画像が利用できない、またはソース URL がない場合は null を返します。

承認

このメソッドを使用するスクリプトには、次のスコープの 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 で指定された画像に置き換えます。サポートされている blob の最大サイズは 2 MB です。

パラメータ

名前説明
blobBlobSource新しいイメージ(Blob)。

戻る

OverGridImage - チェーン用のこの画像。

承認

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

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

replace(url)

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

パラメータ

名前説明
urlString新しい画像の 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)

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

パラメータ

名前説明
descriptionString画像の新しい代替テキストの説明。

戻る

OverGridImage - チェーン用のこの画像。

承認

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

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

setAltTextTitle(title)

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

パラメータ

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

戻る

OverGridImage - チェーン用のこの画像。

承認

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

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

setAnchorCell(cell)

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

パラメータ

名前説明
cellRange新しいアンカーセル。

戻る

OverGridImage - チェーン用のこの画像。

承認

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

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

setAnchorCellXOffset(offset)

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

パラメータ

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

戻る

OverGridImage - チェーン用のこの画像。

承認

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

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

setAnchorCellYOffset(offset)

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

パラメータ

名前説明
offsetInteger新しい垂直ピクセル オフセット。

戻る

OverGridImage - チェーン用のこの画像。

承認

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

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

setHeight(height)

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

パラメータ

名前説明
heightInteger希望する高さ(ピクセル単位)。

戻る

OverGridImage - チェーン用の画像。

承認

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

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

setWidth(width)

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

パラメータ

名前説明
widthInteger希望する幅(ピクセル単位)。

戻る

OverGridImage - チェーン用の画像。

承認

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

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