Class CellImageBuilder

CellImageBuilder

Builder for CellImage. Mit diesem Builder wird der Bildwert erstellt, der erforderlich ist, um einer Zelle ein Bild hinzuzufügen.

Attribute

Attribut	Typ	Beschreibung
valueType	ValueType	Der Werttyp des Zellenbilds, also ValueType.IMAGE.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
build()	CellImage	Erstellt den Bildwerttyp, der zum Hinzufügen eines Bilds zu einer Zelle erforderlich ist.
getAltTextDescription()	String	Gibt die Alt-Text-Beschreibung für dieses Bild zurück.
getAltTextTitle()	String	Gibt den Titel des Alt-Texts für dieses Bild zurück.
getContentUrl()	String	Gibt eine von Google gehostete URL zum Bild zurück.
setAltTextDescription(description)	CellImage	Hier wird der Alt-Text für dieses Bild festgelegt.
setAltTextTitle(title)	CellImage	Legt den Titel des Alt-Texts für dieses Bild fest.
setSourceUrl(url)	CellImageBuilder	Legt die URL der Bildquelle fest.
toBuilder()	CellImageBuilder	Erstellt einen Zellenbild-Builder basierend auf den aktuellen Bildeigenschaften.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getUrl()	String	Die Quell-URL des Bilds.

Detaillierte Dokumentation

build()

Erstellt den Bildwerttyp, der zum Hinzufügen eines Bilds zu einer Zelle erforderlich ist. Der Bildwert wird aus den Bildeigenschaften erstellt, die dem Builder hinzugefügt wurden, z. B. die Quell-URL.

Rückflug

CellImage: Eine Darstellung des Bilds, das einer Zelle hinzugefügt werden soll.

---

getAltTextDescription()

Gibt die Alt-Text-Beschreibung für dieses Bild zurück.

Rückflug

String: Beschreibung des alternativen Texts.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getAltTextTitle()

Gibt den Titel des Alt-Texts für dieses Bild zurück.

Rückflug

String: Der Titel des Alt-Texts.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getContentUrl()

Gibt eine von Google gehostete URL zum Bild zurück. Diese URL ist mit dem Konto des Anfragenden getaggt, sodass alle Nutzer mit der URL auf das Bild zugreifen können, als wären sie der ursprüngliche Anfragende. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen der Tabelle ändern. Die zurückgegebene URL läuft nach kurzer Zeit ab.

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

Rückflug

String: Die von Google gehostete URL des Bilds.

---

setAltTextDescription(description)

Hier wird der Alt-Text für dieses Bild festgelegt.

Parameter

Name	Typ	Beschreibung
description	String	Der neue Alt-Text für das Bild.

Rückflug

CellImage – Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setAltTextTitle(title)

Legt den Titel des Alt-Texts für dieses Bild fest.

Parameter

Name	Typ	Beschreibung
title	String	Der neue Alt-Text-Titel für das Bild.

Rückflug

CellImage – Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setSourceUrl(url)

Legt die URL der Bildquelle fest.

Parameter

Name	Typ	Beschreibung
url	String	Die URL für das Bild.

Rückflug

CellImageBuilder – Dieser Builder zur Verkettung.

---

toBuilder()

Erstellt einen Zellenbild-Builder basierend auf den aktuellen Bildeigenschaften. Verwenden Sie setSourceUrl(url), um die Quell-URL des neuen Bilds festzulegen. Anschließend können Sie sie mit Range.setValue(value) oder Range.setValues(values) einer Zelle hinzufügen.

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

Rückflug

CellImageBuilder: Ein Builder, der einen Bildwerttyp basierend auf den angegebenen Bildeigenschaften erstellt.

Eingestellte Methoden

getUrl()

Veraltet. Bei den meisten neu eingefügten Bildern ist die Quell-URL nicht verfügbar.

Die Quell-URL des Bilds. Gibt einen leeren String zurück, wenn die URL nicht verfügbar ist. Bei den meisten neu eingefügten Bildern ist die Quell-URL unabhängig davon, wie das Bild eingefügt wurde, nicht verfügbar.

Rückflug

String: Die Quell-URL des Bildes, falls verfügbar. Andernfalls wird ein leerer String zurückgegeben.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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