Class CellImageBuilder

CellImageBuilder

Builder für CellImage. Dieser Builder erstellt den Bildwert, der erforderlich ist, um einer Zelle ein Bild hinzuzufügen.

Attribute

PropertyTypBeschreibung
valueTypeValueTypeEin auf ValueType.IMAGE festgelegtes Feld, das den Bildwerttyp darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
build()CellImageErstellt den Bildwerttyp, der zum Hinzufügen eines Bildes zu einer Zelle erforderlich ist.
getAltTextDescription()StringGibt die Beschreibung des alternativen Texts für dieses Bild zurück.
getAltTextTitle()StringGibt den Titel des alternativen Texts für dieses Bild zurück.
getContentUrl()StringGibt eine von Google gehostete URL zum Bild zurück.
getUrl()StringRuft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist.
setAltTextDescription(description)CellImageLegt die Alt-Text-Beschreibung für dieses Bild fest.
setAltTextTitle(title)CellImageLegt den Alt-Texttitel für dieses Bild fest.
setSourceUrl(url)CellImageBuilderLegt die URL der Bildquelle fest.
toBuilder()CellImageBuilderErstellt 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

NameTypBeschreibung
descriptionStringDie 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

NameTypBeschreibung
titleStringDer 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

NameTypBeschreibung
urlStringDie 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.