Class OverGridImage

OverGridImage

E-tablodaki ızgara üzerinde bir resmi temsil eder.

Yöntemler

YöntemDönüş türüKısa açıklama
assignScript(functionName)OverGridImageBelirtilen işlev adına sahip işlevi bu resme atar.
getAltTextDescription()StringBu görselin alternatif metin açıklamasını döndürür.
getAltTextTitle()StringBu resmin alternatif metin başlığını döndürür.
getAnchorCell()RangeResmin bağlı olduğu hücreyi döndürür.
getAnchorCellXOffset()IntegerSabitleme hücresinden yatay piksel uzaklığını döndürür.
getAnchorCellYOffset()IntegerBağlantı hücresinden dikey piksel uzaklığını döndürür.
getHeight()IntegerBu görselin gerçek yüksekliğini piksel cinsinden döndürür.
getInherentHeight()IntegerBu görselin doğal yüksekliğini piksel cinsinden döndürür.
getInherentWidth()IntegerBu görselin doğal yüksekliğini piksel cinsinden döndürür.
getScript()StringBu resme atanan işlevin adını döndürür.
getSheet()SheetBu resmin bulunduğu sayfayı döndürür.
getUrl()StringResmin kaynak URL'sini alır; URL kullanılamıyorsa null değerini döndürür.
getWidth()IntegerBu görselin gerçek genişliğini piksel cinsinden döndürür.
remove()voidBu resmi e-tablodan siler.
replace(blob)OverGridImageBu resmi, sağlanan BlobSource tarafından belirtilen resimle değiştirir.
replace(url)OverGridImageBu resmi, belirtilen URL'deki bir resimle değiştirir.
resetSize()OverGridImageBu resmi doğal boyutlarına sıfırlar.
setAltTextDescription(description)OverGridImageBu görselin alternatif metin açıklamasını ayarlar.
setAltTextTitle(title)OverGridImageBu görsel için alternatif metin başlığını ayarlar.
setAnchorCell(cell)OverGridImageResmin bağlı olduğu hücreyi ayarlar.
setAnchorCellXOffset(offset)OverGridImageSabit hücreden yatay piksel uzaklığını ayarlar.
setAnchorCellYOffset(offset)OverGridImageSabit hücreden dikey piksel uzaklığını ayarlar.
setHeight(height)OverGridImageBu resmin gerçek yüksekliğini piksel cinsinden ayarlar.
setWidth(width)OverGridImageBu resmin gerçek genişliğini piksel cinsinden ayarlar.

Ayrıntılı belgeler

assignScript(functionName)

Belirtilen işlev adına sahip işlevi bu resme atar.

Parametreler

AdTürAçıklama
functionNameStringBelirtilen işlevin adı. Bu, herkese açık bir üst düzey olmalıdır işlevini kullanmayın (ör. privateFunction_ gibi).

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

getAltTextDescription()

Bu görselin alternatif metin açıklamasını döndürür.

Return

String — Alternatif metin açıklaması.

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

getAltTextTitle()

Bu resmin alternatif metin başlığını döndürür.

Return

String: Alternatif metnin başlığı.

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

getAnchorCell()

Resmin bağlı olduğu hücreyi döndürür.

Return

Range — Sabit hücre.

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

getAnchorCellXOffset()

Sabitleme hücresinden yatay piksel uzaklığını döndürür.

Return

Integer — Yatay piksel uzaklığı.

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

getAnchorCellYOffset()

Bağlantı hücresinden dikey piksel uzaklığını döndürür.

Return

Integer — Dikey piksel uzaklığı.

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 görselin gerçek yüksekliğini piksel cinsinden döndürür. 

// Logs the height of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

Return

Integer — Görselin 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

getInherentHeight()

Bu görselin doğal yüksekliğini piksel cinsinden döndürür.

Return

Integer — Piksel cinsinden doğal yükseklik.

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

getInherentWidth()

Bu görselin doğal yüksekliğini piksel cinsinden döndürür.

Return

Integer: Piksel cinsinden doğal genişlik.

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

getScript()

Bu resme atanan işlevin adını döndürür.

Return

String: İşlevin 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 resmin bulunduğu sayfayı döndürür. 

// Logs the parent sheet of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

Return

Sheet: Resmin 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

getUrl()

Resmin kaynak URL'sini alır; URL kullanılamıyorsa null değerini döndürür. Resim bir API kullanılarak URL tarafından eklendiyse bu yöntem, resim ekleme sırasında sağlanan URL'yi döndürür.

Return

String: Varsa resim URL'si; resim mevcut değilse veya yoksa null değerini döndürür bir kaynak URL'ye sahip olmalıdır.

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 görselin gerçek genişliğini piksel cinsinden döndürür. 

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

Return

Integer — Görselin 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

remove()

Bu resmi e-tablodan siler. Resimde yapılan diğer herhangi bir işlem komut dosyasıyla sonuçlanır hatası. 

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[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

replace(blob)

Bu resmi, sağlanan BlobSource tarafından belirtilen resimle değiştirir. Maksimum desteklenen blob boyutu 2 MB'tır.

Parametreler

AdTürAçıklama
blobBlobSourceBlob olarak yeni resim.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

replace(url)

Bu resmi, belirtilen URL'deki bir resimle değiştirir.

Parametreler

AdTürAçıklama
urlStringYeni resmin URL'si.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

resetSize()

Bu resmi doğal boyutlarına sıfırlar.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

setAltTextDescription(description)

Bu görselin alternatif metin açıklamasını ayarlar.

Parametreler

AdTürAçıklama
descriptionStringResmin yeni alternatif metin açıklaması.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

setAltTextTitle(title)

Bu görsel için alternatif metin başlığını ayarlar.

Parametreler

AdTürAçıklama
titleStringResmin yeni alternatif metin başlığı.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

setAnchorCell(cell)

Resmin bağlı olduğu hücreyi ayarlar.

Parametreler

AdTürAçıklama
cellRangeYeni bağlantı hücresi.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

setAnchorCellXOffset(offset)

Sabit hücreden yatay piksel uzaklığını ayarlar.

Parametreler

AdTürAçıklama
offsetIntegerYeni yatay piksel uzaklığı.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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

setAnchorCellYOffset(offset)

Sabit hücreden dikey piksel uzaklığını ayarlar.

Parametreler

AdTürAçıklama
offsetIntegerYeni dikey piksel ofseti.

Return

OverGridImage — Zincirleme amaçlı bu resim.

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 resmin gerçek yüksekliğini piksel cinsinden ayarlar.

Parametreler

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

Return

OverGridImage — Zincirleme resmi.

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 resmin gerçek genişliğini piksel cinsinden ayarlar.

Parametreler

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

Return

OverGridImage — Zincirleme resmi.

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