Class CellImageBuilder

CellImageBuilder

Builder untuk CellImage. Builder ini membuat nilai gambar yang diperlukan untuk menambahkan gambar ke sel.

Properti

PropertiJenisDeskripsi
valueTypeValueTypeJenis nilai gambar sel, yaitu ValueType.IMAGE.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
build()CellImageMembuat jenis nilai gambar yang diperlukan untuk menambahkan gambar ke sel.
getAltTextDescription()StringMenampilkan deskripsi teks alternatif untuk gambar ini.
getAltTextTitle()StringMenampilkan judul teks alternatif untuk gambar ini.
getContentUrl()StringMenampilkan URL yang dihosting Google ke gambar.
setAltTextDescription(description)CellImageMenetapkan deskripsi teks alternatif untuk gambar ini.
setAltTextTitle(title)CellImageMenetapkan judul teks alternatif untuk gambar ini.
setSourceUrl(url)CellImageBuilderMenetapkan URL sumber gambar.
toBuilder()CellImageBuilderMembuat builder gambar sel berdasarkan properti gambar saat ini.

Dokumentasi mendetail

build()

Membuat jenis nilai gambar yang diperlukan untuk menambahkan gambar ke sel. Nilai gambar dibuat dari properti gambar yang ditambahkan ke builder, seperti URL sumber.

Pulang pergi

CellImage — Representasi gambar yang akan ditambahkan ke sel.


getAltTextDescription()

Menampilkan deskripsi teks alternatif untuk gambar ini.

Pulang pergi

String — Deskripsi teks alternatif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getAltTextTitle()

Menampilkan judul teks alternatif untuk gambar ini.

Pulang pergi

String — Judul teks alternatif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

getContentUrl()

Menampilkan URL yang dihosting Google ke gambar. URL ini diberi tag dengan akun pemohon, sehingga siapa pun yang memiliki URL tersebut dapat mengakses gambar sebagai pemohon asli. Akses ke gambar mungkin hilang jika setelan berbagi spreadsheet berubah. URL yang ditampilkan akan berakhir masa berlakunya setelah beberapa saat.

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

Pulang pergi

String — URL gambar yang dihosting Google.


setAltTextDescription(description)

Menetapkan deskripsi teks alternatif untuk gambar ini.

Parameter

NamaJenisDeskripsi
descriptionStringDeskripsi teks alternatif baru untuk gambar.

Pulang pergi

CellImage — Gambar ini, untuk penyambungan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setAltTextTitle(title)

Menetapkan judul teks alternatif untuk gambar ini.

Parameter

NamaJenisDeskripsi
titleStringJudul teks alternatif baru untuk gambar.

Pulang pergi

CellImage — Gambar ini, untuk penyambungan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

setSourceUrl(url)

Menetapkan URL sumber gambar.

Parameter

NamaJenisDeskripsi
urlStringURL untuk gambar.

Pulang pergi

CellImageBuilder — Builder ini, untuk pembuatan rantai.


toBuilder()

Membuat builder gambar sel berdasarkan properti gambar saat ini. Gunakan setSourceUrl(url) untuk menetapkan URL sumber image baru. Kemudian, Anda dapat menambahkannya ke sel menggunakan Range.setValue(value) atau Range.setValues(values).

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

Pulang pergi

CellImageBuilder — Builder yang membuat jenis nilai gambar berdasarkan properti gambar yang diberikan.

Metode yang tidak digunakan lagi