Diese Seite wurde von der Cloud Translation API übersetzt.

Class 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