Class CellImageBuilder

CellImageBuilder

Builder for CellImage. Mit diesem Builder wird der Bildwert erstellt, der erforderlich ist, um einer Zelle ein Bild hinzuzufügen.

Attribute

AttributTypBeschreibung
valueTypeValueTypeEin Feld, das auf ValueType.IMAGE festgelegt ist und den Bildwerttyp darstellt.

Methoden

MethodeRückgabetypKurzbeschreibung
build()CellImageErstellt den Bildwerttyp, der zum Hinzufügen eines Bilds zu einer Zelle erforderlich ist.
getAltTextDescription()StringGibt die Alt-Text-Beschreibung für dieses Bild zurück.
getAltTextTitle()StringGibt den Titel des Alt-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. Wenn die URL nicht verfügbar ist, wird null zurückgegeben.
setAltTextDescription(description)CellImageHier wird der Alt-Text für dieses Bild festgelegt.
setAltTextTitle(title)CellImageLegt den Titel des Alt-Texts für dieses Bild fest.
setSourceUrl(url)CellImageBuilderLegt die URL der Bildquelle fest.
toBuilder()CellImageBuilderErstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, damit Sie es in eine Zelle einfügen können.

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.

Rückflug

String: Die von Google gehostete URL des Bilds.


getUrl()

Ruft die Quell-URL des Bildes ab. Wenn die URL nicht verfügbar ist, wird null zurückgegeben. Wenn das Bild über eine API per URL eingefügt wurde, gibt diese Methode die beim Einfügen des Bildes angegebene URL zurück.

Rückflug

String: Die Bild-URL, falls verfügbar. Es wird null zurückgegeben, wenn das Bild nicht verfügbar ist oder keine Quell-URL hat.

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

setAltTextDescription(description)

Hier wird der Alt-Text für dieses Bild festgelegt.

Parameter

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

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

NameTypBeschreibung
urlStringDie URL für das Bild.

Rückflug

CellImageBuilder – Dieser Builder zur Verkettung.


toBuilder()

Erstellt einen Builder, der ein Bild in einen Bildwerttyp umwandelt, damit 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 sie mit Range.setValue(value) oder Range.setValues(values) einer Zelle hinzufügen.

Rückflug

CellImageBuilder: Ein Builder, der einen Bildwerttyp basierend auf den angegebenen Bildeigenschaften erstellt.