Class Drawing

Gambar

Mewakili gambar di atas sheet dalam spreadsheet.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getContainerInfo()ContainerInfoMendapatkan informasi tentang posisi gambar di sheet.
getHeight()IntegerMenampilkan tinggi sebenarnya gambar ini dalam piksel.
getOnAction()StringMenampilkan nama makro yang dilampirkan ke gambar ini.
getSheet()SheetMenampilkan sheet tempat gambar ini muncul.
getWidth()IntegerMenampilkan lebar sebenarnya gambar ini dalam piksel.
getZIndex()NumberMenampilkan indeks z dari gambar ini.
remove()voidMenghapus gambar ini dari spreadsheet.
setHeight(height)DrawingMenetapkan tinggi sebenarnya gambar ini dalam piksel.
setOnAction(macroName)DrawingMenetapkan fungsi makro untuk gambar ini.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingMenetapkan posisi tempat gambar muncul di sheet.
setWidth(width)DrawingMenetapkan lebar sebenarnya gambar ini dalam piksel.
setZIndex(zIndex)DrawingMenetapkan indeks z untuk gambar ini.

Dokumentasi mendetail

getContainerInfo()

Mendapatkan informasi tentang posisi gambar di sheet.

Return

ContainerInfo — Objek yang berisi posisi penampung gambar.

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

// Logs the height of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[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

getOnAction()

Menampilkan nama makro yang dilampirkan ke gambar ini.

// Logs the macro name of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Return

String — Nama makro yang dilampirkan ke gambar ini.

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 drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

Return

Sheet — Sheet yang menampilkan gambar.

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 drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[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

getZIndex()

Menampilkan indeks z dari gambar ini.

// Logs the z-index of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

Return

Number - Indeks Z gambar ini.

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 menyebabkan error skrip.

// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[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

setHeight(height)

Menetapkan tinggi sebenarnya gambar ini dalam piksel.

Parameter

NameJenisDeskripsi
heightIntegerTinggi yang diinginkan dalam piksel.

Return

Drawing — Gambar ini, 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

setOnAction(macroName)

Menetapkan fungsi makro untuk gambar ini.

Parameter

NameJenisDeskripsi
macroNameStringNama fungsi makro.

Return

Drawing — Gambar ini, untuk pembuatan rantai.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Menetapkan posisi tempat gambar muncul di sheet. Indeks posisi kolom dan baris anchor diindeks 1.

Parameter

NameJenisDeskripsi
anchorRowPosIntegerSisi atas gambar terletak di baris ini.
anchorColPosIntegerSisi atas gambar berlabuh di kolom ini.
offsetXIntegerOffset horizontal dari sudut sel dalam piksel.
offsetYIntegerOffset vertikal dari sudut sel dalam piksel.

Return

Drawing — Gambar ini, 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

NameJenisDeskripsi
widthIntegerLebar yang diinginkan dalam piksel.

Return

Drawing — Gambar ini, 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

setZIndex(zIndex)

Menetapkan indeks z untuk gambar ini.

Parameter

NameJenisDeskripsi
zIndexNumberIndeks Z gambar ini.

Return

Drawing — Gambar ini, untuk pembuatan rantai.