Builder für CellImage. Dieser Builder erstellt den Bildwert, der erforderlich ist, um einer Zelle ein Bild hinzuzufügen.
Attribute
| Property | Typ | Beschreibung |
|---|---|---|
valueType | ValueType | Ein auf ValueType.IMAGE festgelegtes Feld, das den Bildwerttyp darstellt. |
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
build() | CellImage | Erstellt den Bildwerttyp, der zum Hinzufügen eines Bildes 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. |
getUrl() | String | Ruft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist. |
setAltTextDescription(description) | CellImage | Legt die Alt-Text-Beschreibung für dieses Bild fest. |
setAltTextTitle(title) | CellImage | Legt den Alt-Texttitel für dieses Bild fest. |
setSourceUrl(url) | CellImageBuilder | Legt die URL der Bildquelle fest. |
toBuilder() | CellImageBuilder | Erstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, sodass Sie es in eine Zelle einfügen können. |
Detaillierte Dokumentation
build()
Erstellt den Bildwerttyp, der zum Hinzufügen eines Bildes zu einer Zelle erforderlich ist. Der Bildwert wird aus den Bildeigenschaften erstellt, die dem Builder hinzugefügt wurden, z. B. die Quell-URL.
Return
CellImage: Eine Darstellung des Bildes, das einer Zelle hinzugefügt werden soll.
getAltTextDescription()
Gibt die Beschreibung des alternativen Texts für dieses Bild zurück.
Return
String: Die Beschreibung des alternativen Texts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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.
Return
String: Der Titel des alternativen Texts.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 Anforderers getaggt, sodass jeder mit der URL effektiv auf das Bild als ursprünglicher Anforderer zugreift. 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.
Return
String: Die von Google gehostete Bild-URL.
getUrl()
Ruft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist. Wenn das Bild per URL mithilfe einer API eingefügt wurde, gibt diese Methode die beim Einfügen des Bildes angegebene URL zurück.
Return
String: Die Bild-URL, falls verfügbar. Gibt null zurück, wenn das Bild nicht verfügbar ist oder keine Quell-URL hat.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
Legt die Alt-Text-Beschreibung für dieses Bild fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
description | String | Die neue Beschreibung des Alt-Textes für das Bild. |
Return
CellImage: Dieses Bild für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
Legt den Alt-Texttitel für dieses Bild fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | Der Titel des neuen Alt-Texts für das Bild. |
Return
CellImage: Dieses Bild für Verkettungen.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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. |
Return
CellImageBuilder: Dieser Builder für Verkettungen.
toBuilder()
Erstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, sodass Sie es in eine Zelle einfügen können. Bevor ein Bild in eine Zelle eingefügt werden kann, muss es als Bildwerttyp erstellt werden.
Anschließend können Sie ihn mit Range.setValue(value) oder Range.setValues(values) in eine Zelle einfügen.
Return
CellImageBuilder: Ein Builder, der einen Bildwerttyp basierend auf den angegebenen Bildeigenschaften erstellt.