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 konumlandırılmasıyla 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üneceği 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 konumlandırılmasıyla ilgili bilgileri alır.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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 ekli makro adı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kapsamların biri 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 kapsamların biri 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 kapsamların biri 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 gerçekleştirilen diğer işlemler komut dosyası hatasına neden olur.

// 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 kapsamların biri 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, zincir bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, zincir bağlantı için.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Çizimin sayfada görüneceği konumu ayarlar. Sabit satır ve sütun konumu dizinleri 1 dizine eklenir.

Parametreler

AdTürAçıklama
anchorRowPosIntegerÇizimin üst tarafı bu satıra sabitlenir.
anchorColPosIntegerÇizimin üst tarafı bu sütuna sabitlenir.
offsetXIntegerHücre köşesinden yatay uzaklık.
offsetYIntegerHücre köşesinden dikey ofsetin piksel cinsinden değeri.

Return

Drawing — Bu çizim, zincir bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, zincir bağlantı için.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, zincir bağlantı için.