Class CellImage

ZelleBild

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 der Zelle hinzufügen.

Attribute

AttributTypBeschreibung
valueTypeValueTypeDer Werttyp des Zellenbilds, also ValueType.IMAGE.

Methoden

MethodeRückgabetypKurzbeschreibung
getAltTextDescription()StringGibt die Alt-Text-Beschreibung für dieses Bild zurück.
getAltTextTitle()StringGibt den Titel des Alt-Texts für dieses Bild zurück.
getContentUrl()StringGibt eine von Google gehostete URL zum Bild zurück.
toBuilder()CellImageBuilderErstellt einen Zellenbild-Builder basierend auf den aktuellen Bildeigenschaften.

Detaillierte Dokumentation

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. Wenn sich die Freigabeeinstellungen der Tabelle ändern, verlieren Sie möglicherweise den Zugriff auf das Bild. 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.

toBuilder()

Erstellt einen Zellenbild-Builder basierend auf den aktuellen Bildeigenschaften. Verwenden Sie CellImageBuilder.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