Class Drawing

Çizim

E-tablodaki bir sayfanın üzerine çizilen bir resmi temsil eder.

Yöntemler

YöntemDönüş türüKısa açıklama
getContainerInfo()ContainerInfoÇizimin sayfadaki konumu hakkında bilgi alır.
getHeight()IntegerBu çizimin piksel cinsinden gerçek yüksekliğini döndürür.
getOnAction()StringBu çizime eklenmiş 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 sayfa üzerinde 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ı dokümanlar

getContainerInfo()

Çizimin sayfadaki konumu hakkında bilgi alır.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getOnAction()

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

remove()

Bu çizimi e-tablodan siler. Çizimde 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Zincirleme için bu çizim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 sayfa üzerinde göründüğü konumu ayarlar. Sabitleme satırı ve sütun konumu dizinleri 1'den başlar.

Parametreler

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

Return

Drawing: Zincirleme için bu çizim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Zincirleme için bu çizim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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.