Class OverGridImage

GambarPetakAtas

Merepresentasikan gambar di atas petak dalam spreadsheet.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
assignScript(functionName)OverGridImageMenetapkan fungsi dengan nama fungsi yang ditentukan ke image ini.
getAltTextDescription()StringMenampilkan deskripsi teks alternatif untuk gambar ini.
getAltTextTitle()StringMenampilkan judul teks alternatif untuk gambar ini.
getAnchorCell()RangeMenampilkan sel tempat gambar ditempelkan.
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 bawaan gambar ini dalam piksel.
getInherentWidth()IntegerMenampilkan tinggi bawaan 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 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 bawaannya.
setAltTextDescription(description)OverGridImageMenetapkan deskripsi teks alternatif untuk gambar ini.
setAltTextTitle(title)OverGridImageMenetapkan judul teks alternatif untuk gambar ini.
setAnchorCell(cell)OverGridImageMenetapkan sel tempat gambar ditempelkan.
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 image ini.

Parameter

NamaJenisDeskripsi
functionNameStringNama fungsi yang ditentukan. Ini harus berupa fungsi level atas publik, bukan fungsi yang diakhiri dengan garis bawah seperti privateFunction_.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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.

Pulang pergi

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.

Pulang pergi

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 ditempelkan.

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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

Pulang pergi

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 bawaan gambar ini dalam piksel.

Pulang pergi

Integer — Tinggi bawaan 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 bawaan gambar ini dalam piksel.

Pulang pergi

Integer — Lebar bawaan 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.

Pulang pergi

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

Pulang pergi

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 selama penyisipan gambar.

Pulang pergi

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

Pulang pergi

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. 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
blobBlobSourceGambar baru sebagai Blob.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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 bawaannya.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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)

Menetapkan judul teks alternatif untuk gambar ini.

Parameter

NamaJenisDeskripsi
titleStringJudul teks alternatif baru untuk gambar.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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 ditempelkan.

Parameter

NamaJenisDeskripsi
cellRangeSel anchor baru.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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 horizontal baru.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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.

Pulang pergi

OverGridImage — Gambar ini, untuk penyambungan.

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.

Pulang pergi

OverGridImage — Gambar untuk pembuatan 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

setWidth(width)

Menetapkan lebar sebenarnya gambar ini dalam piksel.

Parameter

NamaJenisDeskripsi
widthIntegerLebar yang diinginkan dalam piksel.

Pulang pergi

OverGridImage — Gambar untuk pembuatan 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