Diese Seite wurde von der Cloud Translation API übersetzt.

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

Attribute

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`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.
`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

`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

`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