Class Drawing

Çizim

E-tablodaki bir sayfa üzerinde yapılan çizimi temsil eder.

Yöntemler

YöntemDönüş türüKısa açıklama
getContainerInfo()ContainerInfoÇizimin sayfada bulunduğu yerle ilgili bilgileri alır.
getHeight()IntegerBu çizimin gerçek yüksekliğini piksel cinsinden döndürür.
getOnAction()StringBu çizime ekli makronun adını döndürür.
getSheet()SheetBu çizimin üzerinde göründüğü sayfayı döndürür.
getWidth()IntegerBu çizimin gerçek genişliğini piksel cinsinden döndürür.
getZIndex()NumberBu çizimin z-endeksini döndürür.
remove()voidBu çizimi e-tablodan siler.
setHeight(height)DrawingBu çizimin gerçek yüksekliğini piksel cinsinden ayarlar.
setOnAction(macroName)DrawingBu çizime bir makro işlevi atar.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingÇizimin sayfada göründüğü konumu ayarlar.
setWidth(width)DrawingBu çizimin gerçek genişliğini piksel cinsinden ayarlar.
setZIndex(zIndex)DrawingBu çizimin z-endeksini ayarlar.

Ayrıntılı belgeler

getContainerInfo()

Çizimin sayfada bulunduğu yerle ilgili bilgileri alır.

Return

ContainerInfo: Çizimin kapsayıcı konumunu içeren nesne.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getHeight()

Bu çizimin gerçek yüksekliğini piksel cinsinden döndürür.

// 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: Çizimin piksel cinsinden yüksekliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getOnAction()

Bu çizime ekli makronun adını döndürür.

// 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: Bu çizime eklenen makro adı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getSheet()

Bu çizimin üzerinde göründüğü sayfayı döndürür.

// 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: Çizimin göründüğü sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getWidth()

Bu çizimin gerçek genişliğini piksel cinsinden döndürür.

// 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: Çizimin piksel cinsinden genişliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getZIndex()

Bu çizimin z-endeksini döndürür.

// 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 — Bu çizimin Z-Endeksi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

remove()

Bu çizimi e-tablodan siler. Çizim üzerinde başka işlemler yapıldığında, komut dosyası hatası.

// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setHeight(height)

Bu çizimin gerçek yüksekliğini piksel cinsinden ayarlar.

Parametreler

AdTürAçıklama
heightIntegerPiksel cinsinden istenen yükseklik.

Return

Drawing — Bu çizim, zincirleme işlem için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setOnAction(macroName)

Bu çizime bir makro işlevi atar.

Parametreler

AdTürAçıklama
macroNameStringMakro işlevinin adı.

Return

Drawing — Bu çizim, zincirleme işlem için.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Çizimin sayfada göründüğü konumu ayarlar. Sabit satır ve sütun konumu dizin 1-endekslidir.

Parametreler

AdTürAçıklama
anchorRowPosIntegerÇizimin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerÇizimin üst tarafı bu sütuna sabitlenmiştir.
offsetXIntegerHücre köşesinden yatay uzaklık (piksel cinsinden).
offsetYIntegerHücre köşesinden dikey uzaklık (piksel cinsinden).

Return

Drawing — Bu çizim, zincirleme işlem için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setWidth(width)

Bu çizimin gerçek genişliğini piksel cinsinden ayarlar.

Parametreler

AdTürAçıklama
widthIntegerPiksel cinsinden istenen genişlik.

Return

Drawing — Bu çizim, zincirleme işlem için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setZIndex(zIndex)

Bu çizimin z-endeksini ayarlar.

Parametreler

AdTürAçıklama
zIndexNumberBu çizimin Z-endeksi.

Return

Drawing — Bu çizim, zincirleme işlem için.