Class Drawing

Gambar

Menampilkan gambar di atas sheet dalam spreadsheet.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getContainerInfo()ContainerInfoMendapatkan informasi tentang posisi gambar dalam sheet.
getHeight()IntegerMenampilkan tinggi sebenarnya gambar ini dalam piksel.
getOnAction()String|nullMenampilkan nama makro yang dilampirkan pada gambar ini.
getSheet()SheetMenampilkan sheet tempat gambar ini muncul.
getWidth()IntegerMenampilkan lebar sebenarnya gambar ini dalam piksel.
getZIndex()NumberMenampilkan z-index gambar ini.
remove()voidMenghapus gambar ini dari spreadsheet.
setHeight(height)DrawingMenetapkan tinggi sebenarnya gambar ini dalam piksel.
setOnAction(macroName)DrawingMenetapkan fungsi makro ke 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 gambar ini.

Dokumentasi mendetail

getContainerInfo()

Mendapatkan informasi tentang posisi gambar dalam sheet.

Pulang pergi

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

getOnAction()

Menampilkan nama makro yang dilampirkan pada gambar ini. 

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

Pulang pergi

String|null — Nama makro yang dilampirkan pada 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[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

getWidth()

Menampilkan lebar sebenarnya gambar ini dalam piksel. 

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

getZIndex()

Menampilkan z-index gambar ini. 

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

Pulang pergi

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. Operasi lebih lanjut pada gambar akan menghasilkan error skrip. 

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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

NamaJenisDeskripsi
heightIntegerTinggi yang diinginkan dalam piksel.

Pulang pergi

Drawing — Gambar ini, untuk penggabungan.

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 ke gambar ini.

Parameter

NamaJenisDeskripsi
macroNameStringNama fungsi makro.

Pulang pergi

Drawing — Gambar ini, untuk penggabungan.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Menetapkan posisi tempat gambar muncul di sheet. Indeks posisi baris dan kolom penahan berbasis 1.

Parameter

NamaJenisDeskripsi
anchorRowPosIntegerSisi atas gambar ditambatkan di baris ini.
anchorColPosIntegerSisi atas gambar ditambatkan di col ini.
offsetXIntegerOffset horizontal dari sudut sel dalam piksel.
offsetYIntegerOffset vertikal dari sudut sel dalam piksel.

Pulang pergi

Drawing — Gambar ini, untuk penggabungan.

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

Drawing — Gambar ini, untuk penggabungan.

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

Parameter

NamaJenisDeskripsi
zIndexNumberIndeks Z gambar ini.

Pulang pergi

Drawing — Gambar ini, untuk penggabungan.