Stellt ein Bild über dem Raster in einer Tabellenkalkulation dar.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
assignScript(functionName) | OverGridImage | Weist diesem Image die Funktion mit dem angegebenen Funktionsnamen zu. |
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. |
getAnchorCell() | Range | Gibt die Zelle zurück, in der ein Bild verankert ist. |
getAnchorCellXOffset() | Integer | Gibt den horizontalen Pixelversatz von der Ankerzelle zurück |
getAnchorCellYOffset() | Integer | Gibt den vertikalen Pixelversatz von der Ankerzelle zurück. |
getHeight() | Integer | Gibt die tatsächliche Höhe dieses Bildes in Pixeln an. |
getInherentHeight() | Integer | Gibt die inhärente Höhe dieses Bildes in Pixeln zurück. |
getInherentWidth() | Integer | Gibt die inhärente Höhe dieses Bildes in Pixeln zurück. |
getScript() | String | Gibt den Namen der Funktion zurück, die diesem Bild zugewiesen ist |
getSheet() | Sheet | Gibt das Tabellenblatt zurück, auf dem dieses Bild angezeigt wird. |
getUrl() | String | Ruft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist. |
getWidth() | Integer | Gibt die tatsächliche Breite dieses Bildes in Pixeln zurück. |
remove() | void | Löscht dieses Bild aus der Tabelle. |
replace(blob) | OverGridImage | Ersetzt dieses Bild durch das im angegebenen BlobSource angegebene Bild. |
replace(url) | OverGridImage | Ersetzt dieses Bild durch das Bild der angegebenen URL. |
resetSize() | OverGridImage | Setzt das Bild auf seine ursprünglichen Abmessungen zurück. |
setAltTextDescription(description) | OverGridImage | Legt die Alt-Text-Beschreibung für dieses Bild fest. |
setAltTextTitle(title) | OverGridImage | Legt den Alt-Texttitel für dieses Bild fest. |
setAnchorCell(cell) | OverGridImage | Legt die Zelle fest, in der ein Bild verankert ist. |
setAnchorCellXOffset(offset) | OverGridImage | Legt den horizontalen Pixelversatz von der Ankerzelle fest. |
setAnchorCellYOffset(offset) | OverGridImage | Legt den vertikalen Pixelversatz von der Ankerzelle fest. |
setHeight(height) | OverGridImage | Legt die tatsächliche Höhe des Bildes in Pixeln fest. |
setWidth(width) | OverGridImage | Legt die tatsächliche Breite des Bildes in Pixeln fest. |
Detaillierte Dokumentation
assignScript(functionName)
Weist diesem Image die Funktion mit dem angegebenen Funktionsnamen zu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
functionName | String | Der Name der angegebenen Funktion. Dabei muss es sich um eine öffentliche Funktion auf oberster Ebene handeln. Sie darf nicht mit einem Unterstrich wie privateFunction_ enden. |
Return
OverGridImage
: 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
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
getAnchorCell()
Gibt die Zelle zurück, in der ein Bild verankert ist.
Return
Range
: Die Ankerzelle.
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
getAnchorCellXOffset()
Gibt den horizontalen Pixelversatz von der Ankerzelle zurück
Return
Integer
: Das horizontale Pixel-Offset.
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
getAnchorCellYOffset()
Gibt den vertikalen Pixelversatz von der Ankerzelle zurück.
Return
Integer
: Das vertikale Pixel-Offset.
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
getHeight()
Gibt die tatsächliche Höhe dieses Bildes in Pixeln an.
// Logs the height of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getHeight()); }
Return
Integer
: Die Höhe des Bildes in Pixeln.
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
getInherentHeight()
Gibt die inhärente Höhe dieses Bildes in Pixeln zurück.
Return
Integer
: Die inhärente Höhe in Pixeln.
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
getInherentWidth()
Gibt die inhärente Höhe dieses Bildes in Pixeln zurück.
Return
Integer
: Die inhärente Breite in Pixeln.
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
getScript()
Gibt den Namen der Funktion zurück, die diesem Bild zugewiesen ist
Return
String
: Der Name der Funktion.
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
getSheet()
Gibt das Tabellenblatt zurück, auf dem dieses Bild angezeigt wird.
// Logs the parent sheet of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getSheet()); }
Return
Sheet
: Das Tabellenblatt, auf dem das Bild angezeigt wird.
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
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
getWidth()
Gibt die tatsächliche Breite dieses Bildes in Pixeln zurück.
// Logs the width of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getWidth()); }
Return
Integer
: Die Breite des Bildes in Pixeln.
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
remove()
Löscht dieses Bild aus der Tabelle. Jeder weitere Vorgang am Bild führt zu einem Skriptfehler.
// Deletes all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { images[i].remove(); }
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
replace(blob)
Ersetzt dieses Bild durch das im angegebenen BlobSource
angegebene Bild. Blobs dürfen maximal 2 MB groß sein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Das neue Bild als Blob. |
Return
OverGridImage
: 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
replace(url)
Ersetzt dieses Bild durch das Bild der angegebenen URL.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die URL des neuen Bildes. |
Return
OverGridImage
: 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
resetSize()
Setzt das Bild auf seine ursprünglichen Abmessungen zurück.
Return
OverGridImage
: 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
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
OverGridImage
: 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
OverGridImage
: 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
setAnchorCell(cell)
Legt die Zelle fest, in der ein Bild verankert ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
cell | Range | Die neue Ankerzelle. |
Return
OverGridImage
: 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
setAnchorCellXOffset(offset)
Legt den horizontalen Pixelversatz von der Ankerzelle fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Integer | Das neue horizontale Pixel-Offset. |
Return
OverGridImage
: 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
setAnchorCellYOffset(offset)
Legt den vertikalen Pixelversatz von der Ankerzelle fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Integer | Das neue vertikale Pixel-Offset. |
Return
OverGridImage
: 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
setHeight(height)
Legt die tatsächliche Höhe des Bildes in Pixeln fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
height | Integer | Die gewünschte Höhe in Pixeln. |
Return
OverGridImage
: Das Bild für die Verkettung.
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
setWidth(width)
Legt die tatsächliche Breite des Bildes in Pixeln fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
width | Integer | Die gewünschte Breite in Pixeln. |
Return
OverGridImage
: Das Bild für die Verkettung.
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