Class OverGridImage

OverGridImage

Menampilkan gambar di atas petak dalam spreadsheet.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
assignScript(functionName)OverGridImageMenetapkan fungsi dengan nama fungsi yang ditentukan ke gambar ini.
getAltTextDescription()StringMenampilkan deskripsi teks alternatif untuk gambar ini.
getAltTextTitle()StringMenampilkan judul teks alternatif untuk gambar ini.
getAnchorCell()RangeMenampilkan sel tempat gambar ditambatkan.
getAnchorCellXOffset()IntegerMenampilkan offset piksel horizontal dari sel anchor.
getAnchorCellYOffset()IntegerMenampilkan offset piksel vertikal dari sel anchor.
getHeight()IntegerMenampilkan tinggi sebenarnya dari gambar ini dalam piksel.
getInherentHeight()IntegerMenampilkan tinggi yang melekat pada gambar ini dalam piksel.
getInherentWidth()IntegerMenampilkan tinggi yang melekat pada gambar ini dalam piksel.
getScript()StringMenampilkan nama fungsi yang ditetapkan ke gambar ini.
getSheet()SheetMenampilkan sheet tempat gambar ini muncul.
getUrl()StringMendapatkan URL sumber gambar; menampilkan null jika URL tidak tersedia.
getWidth()IntegerMenampilkan lebar sebenarnya dari gambar ini dalam piksel.
remove()voidMenghapus gambar ini dari spreadsheet.
replace(blob)OverGridImageMengganti gambar ini dengan gambar yang ditentukan oleh BlobSource yang disediakan.
replace(url)OverGridImageMengganti gambar ini dengan gambar dari URL yang ditentukan.
resetSize()OverGridImageMereset gambar ini ke dimensi yang melekat.
setAltTextDescription(description)OverGridImageMenetapkan deskripsi teks alternatif untuk gambar ini.
setAltTextTitle(title)OverGridImageMenyetel judul teks alternatif untuk gambar ini.
setAnchorCell(cell)OverGridImageMenetapkan sel tempat gambar ditambatkan.
setAnchorCellXOffset(offset)OverGridImageMenetapkan offset piksel horizontal dari sel anchor.
setAnchorCellYOffset(offset)OverGridImageMenetapkan offset piksel vertikal dari sel anchor.
setHeight(height)OverGridImageMenetapkan tinggi sebenarnya gambar ini dalam piksel.
setWidth(width)OverGridImageMenetapkan lebar sebenarnya gambar ini dalam piksel.

Dokumentasi mendetail

assignScript(functionName)

Menetapkan fungsi dengan nama fungsi yang ditentukan ke gambar ini.

Parameter

NamaJenisDeskripsi
functionNameStringNama fungsi yang ditentukan. Fungsi ini harus berupa fungsi tingkat atas publik, bukan yang diakhiri dengan garis bawah seperti privateFunction_.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAltTextDescription()

Menampilkan deskripsi teks alternatif untuk gambar ini.

Return

String — Deskripsi teks alternatif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAltTextTitle()

Menampilkan judul teks alternatif untuk gambar ini.

Return

String — Judul teks alternatif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAnchorCell()

Menampilkan sel tempat gambar ditambatkan.

Return

Range — Sel anchor.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAnchorCellXOffset()

Menampilkan offset piksel horizontal dari sel anchor.

Return

Integer — Offset piksel horizontal.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAnchorCellYOffset()

Menampilkan offset piksel vertikal dari sel anchor.

Return

Integer — Offset piksel vertikal.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getHeight()

Menampilkan tinggi sebenarnya dari gambar ini dalam piksel.

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

Return

Integer — Tinggi gambar dalam piksel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getInherentHeight()

Menampilkan tinggi yang melekat pada gambar ini dalam piksel.

Return

Integer — Tinggi inheren dalam piksel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getInherentWidth()

Menampilkan tinggi yang melekat pada gambar ini dalam piksel.

Return

Integer — Lebar inheren dalam piksel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getScript()

Menampilkan nama fungsi yang ditetapkan ke gambar ini.

Return

String — Nama fungsi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getSheet()

Menampilkan sheet tempat gambar ini muncul.

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

Return

Sheet — Sheet tempat gambar muncul.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getUrl()

Mendapatkan URL sumber gambar; menampilkan null jika URL tidak tersedia. Jika gambar disisipkan oleh URL menggunakan API, metode ini akan menampilkan URL yang diberikan saat penyisipan gambar.

Return

String — URL gambar jika tersedia; menampilkan null jika gambar tidak tersedia atau tidak memiliki URL sumber.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getWidth()

Menampilkan lebar sebenarnya dari gambar ini dalam piksel.

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

Return

Integer — Lebar gambar dalam piksel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

remove()

Menghapus gambar ini dari spreadsheet. Setiap operasi lebih lanjut pada gambar akan menghasilkan error skrip.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

replace(blob)

Mengganti gambar ini dengan gambar yang ditentukan oleh BlobSource yang disediakan. Ukuran blob maksimum yang didukung adalah 2 MB.

Parameter

NamaJenisDeskripsi
blobBlobSourceImage baru sebagai Blob.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

replace(url)

Mengganti gambar ini dengan gambar dari URL yang ditentukan.

Parameter

NamaJenisDeskripsi
urlStringURL gambar baru.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

resetSize()

Mereset gambar ini ke dimensi yang melekat.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setAltTextDescription(description)

Menetapkan deskripsi teks alternatif untuk gambar ini.

Parameter

NamaJenisDeskripsi
descriptionStringDeskripsi teks alternatif baru untuk gambar.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setAltTextTitle(title)

Menyetel judul teks alternatif untuk gambar ini.

Parameter

NamaJenisDeskripsi
titleStringJudul teks alternatif baru untuk gambar.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setAnchorCell(cell)

Menetapkan sel tempat gambar ditambatkan.

Parameter

NamaJenisDeskripsi
cellRangeSel anchor baru.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setAnchorCellXOffset(offset)

Menetapkan offset piksel horizontal dari sel anchor.

Parameter

NamaJenisDeskripsi
offsetIntegerOffset piksel cakrawala baru.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setAnchorCellYOffset(offset)

Menetapkan offset piksel vertikal dari sel anchor.

Parameter

NamaJenisDeskripsi
offsetIntegerOffset piksel vertikal baru.

Return

OverGridImage — Gambar ini, untuk membuat rantai.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setHeight(height)

Menetapkan tinggi sebenarnya gambar ini dalam piksel.

Parameter

NamaJenisDeskripsi
heightIntegerTinggi yang diinginkan dalam piksel.

Return

OverGridImage — Gambar untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setWidth(width)

Menetapkan lebar sebenarnya gambar ini dalam piksel.

Parameter

NamaJenisDeskripsi
widthIntegerLebar yang diinginkan dalam piksel.

Return

OverGridImage — Gambar untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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