Elektronik tablolarda ızgara üzerindeki bir resmi temsil eder.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
assignScript(functionName) | OverGridImage | Belirtilen işlev adına sahip işlevi bu resme atar. |
getAltTextDescription() | String | Bu görselin alternatif metin açıklamasını döndürür. |
getAltTextTitle() | String | Bu görselin alternatif metin başlığını döndürür. |
getAnchorCell() | Range | Bir resmin sabitlendiği hücreyi döndürür. |
getAnchorCellXOffset() | Integer | Sabitleme hücresinden yatay piksel ofsetini döndürür. |
getAnchorCellYOffset() | Integer | Sabitleme hücresinden dikey piksel ofsetini döndürür. |
getHeight() | Integer | Bu resmin gerçek yüksekliğini piksel cinsinden döndürür. |
getInherentHeight() | Integer | Bu resmin doğal yüksekliğini piksel cinsinden döndürür. |
getInherentWidth() | Integer | Bu resmin doğal yüksekliğini piksel cinsinden döndürür. |
getScript() | String | Bu görüntüye atanan işlevin adını döndürür. |
getSheet() | Sheet | Bu resmin göründüğü sayfayı döndürür. |
getUrl() | String | Resmin kaynak URL'sini alır; URL kullanılamıyorsa null değerini döndürür. |
getWidth() | Integer | Bu resmin gerçek genişliğini piksel cinsinden döndürür. |
remove() | void | Bu resmi e-tablodan siler. |
replace(blob) | OverGridImage | Bu resmi, sağlanan BlobSource ile belirtilen resimle değiştirir. |
replace(url) | OverGridImage | Bu resmi, belirtilen URL'deki resimle değiştirir. |
resetSize() | OverGridImage | Bu resmi doğal boyutlarına sıfırlar. |
setAltTextDescription(description) | OverGridImage | Bu görsel için alternatif metin açıklamasını ayarlar. |
setAltTextTitle(title) | OverGridImage | Bu görsel için alternatif metin başlığını ayarlar. |
setAnchorCell(cell) | OverGridImage | Resmin bağlı olduğu hücreyi ayarlar. |
setAnchorCellXOffset(offset) | OverGridImage | Sabitleme hücresine göre yatay piksel ofsetini ayarlar. |
setAnchorCellYOffset(offset) | OverGridImage | Sabitleme hücresine olan dikey piksel ofsetini ayarlar. |
setHeight(height) | OverGridImage | Bu resmin gerçek yüksekliğini piksel cinsinden ayarlar. |
setWidth(width) | OverGridImage | Bu resmin gerçek genişliğini piksel olarak ayarlar. |
Ayrıntılı belgeler
assignScript(functionName)
Belirtilen işlev adına sahip işlevi bu resme atar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
functionName | String | Belirtilen işlevin adı. Bu, privateFunction_ gibi alt çizgi ile biten bir işlev değil, herkese açık bir üst düzey işlev olmalıdır. |
Return
OverGridImage
— Bu resim, 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
getAltTextDescription()
Bu görselin alternatif metin açıklamasını döndürür.
Return
String
: Alternatif metnin açıklaması.
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
getAltTextTitle()
Bu görselin 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
Bir resmin sabitlendiği hücreyi döndürür.
Return
Range
: Sabit hücre.
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
getAnchorCellXOffset()
Sabitleme hücresinden yatay piksel ofsetini döndürür.
Return
Integer
: Yatay piksel göreli konumu.
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
getAnchorCellYOffset()
Sabitleme hücresinden dikey piksel ofsetini döndürür.
Return
Integer
: Dikey piksel ofseti.
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 resmin 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
: Resmin 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
getInherentHeight()
Bu resmin doğal yüksekliğini piksel cinsinden döndürür.
Return
Integer
: Doğal yükseklik (piksel).
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
getInherentWidth()
Bu resmin doğal yüksekliğini piksel cinsinden döndürür.
Return
Integer
: Doğal genişlik (piksel cinsinden).
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
getScript()
Bu görüntüye atanan işlevin adını döndürür.
Return
String
: İşlevin 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 resmin göründüğü 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 kapsamların biri 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, API kullanılarak URL aracılığıyla eklendiyse bu yöntem, resim ekleme sırasında sağlanan URL'yi döndürür.
Return
String
— Varsa resmin URL'si. Resim kullanılamıyorsa veya kaynak URL'si yoksa null
değerini döndürür.
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 resmin 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
: Resmin 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
remove()
Bu resmi e-tablodan siler. Resim üzerinde gerçekleştirilen diğer işlemler komut dosyası hatasına neden olur.
// 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 kapsamların biri 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
ile belirtilen resimle değiştirir. Desteklenen maksimum blob boyutu 2 MB'tır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blob | BlobSource | Blob olarak yeni resim. |
Return
OverGridImage
— Bu resim, 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
replace(url)
Bu resmi, belirtilen URL'deki resimle değiştirir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | Yeni resmin URL'si. |
Return
OverGridImage
— Bu resim, 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
resetSize()
Bu resmi doğal boyutlarına sıfırlar.
Return
OverGridImage
— Bu resim, 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
setAltTextDescription(description)
Bu görsel için alternatif metin açıklamasını ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Resim için yeni alternatif metin açıklaması. |
Return
OverGridImage
— Bu resim, 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
setAltTextTitle(title)
Bu görsel için alternatif metin başlığını ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Resim için yeni alternatif metin başlığı. |
Return
OverGridImage
— Bu resim, 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
setAnchorCell(cell)
Resmin bağlı olduğu hücreyi ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
cell | Range | Yeni sabit hücre. |
Return
OverGridImage
— Bu resim, 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
setAnchorCellXOffset(offset)
Sabitleme hücresine göre yatay piksel ofsetini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
offset | Integer | Yeni yatay piksel göreli konumu. |
Return
OverGridImage
— Bu resim, 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
setAnchorCellYOffset(offset)
Sabitleme hücresine olan dikey piksel ofsetini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
offset | Integer | Yeni dikey piksel ofseti. |
Return
OverGridImage
— Bu resim, 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
setHeight(height)
Bu resmin gerçek yüksekliğini piksel cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
height | Integer | Piksel cinsinden istenen yükseklik. |
Return
OverGridImage
: Zincirleme için resim.
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 resmin gerçek genişliğini piksel olarak ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
width | Integer | Piksel cinsinden istenen genişlik. |
Return
OverGridImage
: Zincirleme için resim.
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