Class CellImageBuilder

CellImageBuilder

Builder für CellImage. Mit diesem Builder wird der Bildwert erstellt, der zum Hinzufügen eines Bilds zu einer Zelle erforderlich ist.

Properties

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

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 Beschreibung des alternativen Texts für dieses Bild zurück.
getAltTextTitle()	String	Gibt den Titel des alternativen Texts für dieses Bild zurück.
getContentUrl()	String	Gibt eine von Google gehostete URL zum Bild zurück.
setAltTextDescription(description)	CellImage	Legt die Beschreibung des alternativen Texts für dieses Bild fest.
setAltTextTitle(title)	CellImage	Legt den Titel des alternativen Texts für dieses Bild fest.
setSourceUrl(url)	CellImageBuilder	Legt die Quell-URL des Bilds fest.
toBuilder()	CellImageBuilder	Erstellt einen Builder für Zellenbilder basierend auf den aktuellen Bildeigenschaften.

Veraltete Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getUrl()	String	Ruft die Quell-URL des Bilds ab.

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ückgabe

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

---

getAltTextDescription()

Gibt die Beschreibung des alternativen Texts für dieses Bild zurück.

Rückgabe

String – Die Beschreibung des alternativen Texts.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getAltTextTitle()

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

Rückgabe

String – Der Titel des alternativen Texts.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

• 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. Jeder, der die URL hat, greift also auf das Bild als ursprünglicher Anfragender zu. 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ückgabe

String – Die von Google gehostete URL des Bilds.

---

setAltTextDescription(description)

Legt die Beschreibung des alternativen Texts für dieses Bild fest.

Parameter

Name	Typ	Beschreibung
description	String	Die neue Beschreibung des alternativen Texts für das Bild.

Rückgabe

CellImage – Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

setAltTextTitle(title)

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

Parameter

Name	Typ	Beschreibung
title	String	Der neue Titel des alternativen Texts für das Bild.

Rückgabe

CellImage – Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

setSourceUrl(url)

Legt die Quell-URL des Bilds fest.

Parameter

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

Rückgabe

CellImageBuilder – Dieser Builder zur Verkettung.

---

toBuilder()

Erstellt einen Builder für Zellenbilder basierend auf den aktuellen Bildeigenschaften. Verwenden Sie setSourceUrl(url), um die Quell-URL des neuen Bilds festzulegen. Anschließend können Sie es 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ückgabe

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

Veraltete Methoden

getUrl()

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

Ruft die Quell-URL des Bilds ab. 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ückgabe

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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