Class Drawing

Gambar

Mewakili gambar di atas sheet dalam spreadsheet.

Metode

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

Dokumentasi mendetail

getContainerInfo()

Mendapatkan informasi tentang posisi gambar dalam 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 dari 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 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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[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

getWidth()

Menampilkan lebar sebenarnya dari 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 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 — Z-Indeks 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 menghasilkan 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)

Menyetel tinggi sebenarnya dari gambar ini dalam piksel.

Parameter

NamaJenisDeskripsi
heightIntegerTinggi yang diinginkan dalam piksel.

Return

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

setOnAction(macroName)

Menetapkan fungsi makro ke gambar ini.

Parameter

NamaJenisDeskripsi
macroNameStringNama fungsi makro.

Return

Drawing — Gambar ini, untuk perantaian.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Menetapkan posisi tempat gambar muncul pada sheet. Indeks posisi baris dan kolom diindeks dengan 1.

Parameter

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

Return

Drawing — Gambar ini, 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 dari gambar ini dalam piksel.

Parameter

NamaJenisDeskripsi
widthIntegerLebar yang diinginkan dalam piksel.

Return

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

setZIndex(zIndex)

Menetapkan indeks z gambar ini.

Parameter

NamaJenisDeskripsi
zIndexNumberZ-indeks gambar ini.

Return

Drawing — Gambar ini, untuk perantaian.