Class CellImageBuilder

CellImageBuilder

CellImage için inşaatçı. Bu oluşturucu, bir hücreye resim eklemek için gereken resim değerini oluşturur.

Özellikler

MülkTürAçıklama
valueTypeValueTypeHücre resminin değer türü (ValueType.IMAGE).

Yöntemler

YöntemDönüş türüKısa açıklama
build()CellImageBir hücreye resim eklemek için gereken resim değeri türünü oluşturur.
getAltTextDescription()StringBu resmin alternatif metin açıklamasını döndürür.
getAltTextTitle()StringBu resmin alternatif metin başlığını döndürür.
getContentUrl()StringResmin Google tarafından barındırılan URL'sini döndürür.
setAltTextDescription(description)CellImageBu resmin alternatif metin açıklamasını ayarlar.
setAltTextTitle(title)CellImageBu resmin alternatif metin başlığını ayarlar.
setSourceUrl(url)CellImageBuilderResim kaynak URL'sini ayarlar.
toBuilder()CellImageBuilderMevcut resim özelliklerine göre bir hücre resim oluşturucu oluşturur.

Ayrıntılı dokümanlar

build()

Bir hücreye resim eklemek için gereken resim değeri türünü oluşturur. Resim değeri, oluşturucuya eklenen resim özelliklerinden (ör. kaynak URL) oluşturulur.

Return

CellImage: Bir hücreye eklenecek resmin temsili.


getAltTextDescription()

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

Return

String: Alternatif metnin açıklaması.

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

getAltTextTitle()

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

Return

String: Alternatif metin başlığı.

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

getContentUrl()

Resmin Google tarafından barındırılan URL'sini döndürür. Bu URL, istek sahibinin hesabıyla etiketlenir. Böylece, URL'ye sahip olan herkes resme orijinal istek sahibi olarak erişebilir. E-tablonun paylaşım ayarları değişirse resme erişim kaybedilebilir. Döndürülen URL'nin süresi kısa bir süre sonra dolar.

const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  console.log(value.getContentUrl());
}

Return

String: Resmin Google tarafından barındırılan URL'si.


setAltTextDescription(description)

Bu resmin alternatif metin açıklamasını ayarlar.

Parametreler

AdTürAçıklama
descriptionStringResim için yeni alternatif metin açıklaması.

Return

CellImage: Zincirleme için bu resim.

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

setAltTextTitle(title)

Bu resmin alternatif metin başlığını ayarlar.

Parametreler

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

Return

CellImage: Zincirleme için bu resim.

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

setSourceUrl(url)

Resim kaynak URL'sini ayarlar.

Parametreler

AdTürAçıklama
urlStringResmin URL'si.

Return

CellImageBuilder: Zincirleme için bu oluşturucu.


toBuilder()

Mevcut resim özelliklerine göre bir hücre resim oluşturucu oluşturur. Yeni resmin kaynak URL'sini ayarlamak için setSourceUrl(url) kullanın. Ardından Range.setValue(value) veya Range.setValues(values) kullanarak bir hücreye ekleyebilirsiniz.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const range = ss.getRange("Sheet1!A1");
const value = range.getValue();
if (value.valueType == SpreadsheetApp.ValueType.IMAGE) {
  const newImage =
      value.toBuilder()
          .setSourceUrl(
              'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
              )
          .build();
  const newRange = ss.getRange("Sheet1!A2");
  newRange.setValue(newImage);
}

Return

CellImageBuilder: Belirtilen resim özelliklerine göre bir resim değeri türü oluşturan bir oluşturucu.

Kullanımdan kaldırılan yöntemler