Class Drawing

Çizim

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

Yöntemler

YöntemDönüş türüKısa açıklama
getContainerInfo()ContainerInfoÇizimin sayfadaki konumuyla ilgili bilgileri alır.
getHeight()IntegerBu çizimin piksel cinsinden gerçek yüksekliğini döndürür.
getOnAction()String|nullBu çizime eklenen makronun adını döndürür.
getSheet()SheetBu çizimin göründüğü sayfayı döndürür.
getWidth()IntegerBu çizimin piksel cinsinden gerçek genişliğini 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 sayfadaki konumuyla ilgili bilgileri alır.

Return

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

Yetkilendirme

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

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

getHeight()

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

// 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());
}

Return

Integer: Çizimin piksel cinsinden yüksekliği.

Yetkilendirme

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

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

getOnAction()

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

// 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());
}

Return

String|null: Bu çizime eklenen makro adı.

Yetkilendirme

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

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

getSheet()

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

// 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());
}

Return

Sheet: Çizimin göründüğü sayfa.

Yetkilendirme

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

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

getWidth()

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

// 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());
}

Return

Integer: Çizimin piksel cinsinden genişliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let 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 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 yapılan diğer işlemler komut dosyası hatasıyla sonuçlanır. 

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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
heightIntegerİstenen yükseklik (piksel cinsinden).

Return

Drawing: Zincirleme için bu çizim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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: Zincirleme için bu çizim.

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Çizimin sayfada görüneceği konumu ayarlar. Sabitleme satırı ve sütun konumu dizinleri 1 tabanlıdır.

Parametreler

AdTürAçıklama
anchorRowPosIntegerÇizimin üst kısmı bu satıra sabitlenir.
anchorColPosIntegerÇizimin üst kısmı bu sütuna sabitlenir.
offsetXIntegerHücre köşesinden piksel cinsinden yatay uzaklık.
offsetYIntegerPiksel cinsinden hücre köşesinden dikey uzaklık.

Return

Drawing: Zincirleme için bu çizim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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
widthIntegerİstenen genişlik (piksel cinsinden).

Return

Drawing: Zincirleme için bu çizim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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: Zincirleme için bu çizim.