Class CellImage

CellImage

Stellt einen Bildwert in einer Zelle dar. Wenn Sie einer Zelle ein Bild hinzufügen möchten, müssen Sie mit SpreadsheetApp.newCellImage() und CellImageBuilder einen neuen Bildwert für das Bild erstellen. Anschließend können Sie mit Range.setValue(value) oder Range.setValues(values) den Bildwert in die Zelle einfügen.

Properties

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getAltTextDescription()	String	Gibt die Alt-Text-Beschreibung für dieses Bild zurück.
getAltTextTitle()	String	Gibt den Alt-Text-Titel für dieses Bild zurück.
getContentUrl()	String	Gibt eine von Google gehostete URL für das Bild zurück.
toBuilder()	CellImageBuilder	Erstellt einen CellImageBuilder basierend auf den aktuellen Bildeigenschaften.

Eingestellte Methoden

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

Detaillierte Dokumentation

getAltTextDescription()

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

Rückflug

String – Die Beschreibung des Alt-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 Alt-Text-Titel für dieses Bild zurück.

Rückflug

String – Der Titel des Alt-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 für das 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ückflug

String: Die von Google gehostete URL des Bildes.

---

toBuilder()

Erstellt einen CellImageBuilder basierend auf den aktuellen Bildeigenschaften. Verwenden Sie CellImageBuilder.setSourceUrl(url), um die Quell-URL des neuen Bildes 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.

Ruft die Quell-URL des Bildes 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 wird, 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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