Stellt ein Bild dar, das einer Zelle hinzugefügt werden soll. 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 Range.setValue(value)
oder Range.setValues(values)
verwenden, um den Bildwert in die Zelle einzufügen.
Attribute
Property | Typ | Beschreibung |
---|---|---|
valueType | ValueType | Ein auf ValueType.IMAGE festgelegtes Feld, das den Bildwerttyp darstellt. |
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
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. |
toBuilder() | CellImageBuilder | Erstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, sodass Sie es in eine Zelle einfügen können. |
Detaillierte Dokumentation
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
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.