Stellt ein Bild über dem Raster in einer Tabelle dar
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
assignScript(functionName) | OverGridImage | Weist diesem Image die Funktion mit dem angegebenen Funktionsnamen zu. |
getAltTextDescription() | String | Gibt die Alt-Textbeschreibung für dieses Bild zurück. |
getAltTextTitle() | String | Gibt den Alt-Texttitel 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 des Bildes in Pixeln zurück. |
getInherentHeight() | Integer | Gibt die inhärente Höhe des Bildes in Pixeln zurück. |
getInherentWidth() | Integer | Gibt die inhärente Höhe des 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 das Bild zu sehen ist |
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 des Bildes in Pixeln zurück. |
remove() | void | Das Bild wird aus der Tabelle gelöscht. |
replace(blob) | OverGridImage | Ersetzt dieses Bild durch das von der angegebenen BlobSource angegebene. |
replace(url) | OverGridImage | Ersetzt dieses Bild durch das Bild aus der angegebenen URL. |
resetSize() | OverGridImage | Setzt dieses Bild auf seine ursprünglichen Abmessungen zurück. |
setAltTextDescription(description) | OverGridImage | Legt die Alt-Textbeschreibung für dieses Bild fest. |
setAltTextTitle(title) | OverGridImage | Legt den Titel des Alt-Texts 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 gegenüber der Ankerzelle fest. |
setAnchorCellYOffset(offset) | OverGridImage | Legt den vertikalen Pixelversatz gegenüber 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. Dies muss eine öffentliche Top-Level-Funktion sein, keine mit einem Unterstrich wie privateFunction_ . |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextDescription()
Gibt die Alt-Textbeschreibung für dieses Bild zurück.
Zurücksenden
String
: Die Alt-Textbeschreibung.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Gibt den Alt-Texttitel für dieses Bild zurück.
Zurücksenden
String
: Der Alt-Texttitel.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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.
Zurücksenden
Range
: Die Ankerzelle.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellXOffset()
Gibt den horizontalen Pixelversatz von der Ankerzelle zurück.
Zurücksenden
Integer
: Der horizontale Pixelversatz.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellYOffset()
Gibt den vertikalen Pixelversatz von der Ankerzelle zurück.
Zurücksenden
Integer
: Der vertikale Pixelversatz.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Gibt die tatsächliche Höhe des Bildes in Pixeln zurück.
// 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()); }
Zurücksenden
Integer
: Die Höhe des Bildes in Pixeln.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentHeight()
Gibt die inhärente Höhe des Bildes in Pixeln zurück.
Zurücksenden
Integer
: Die inhärente Höhe in Pixeln.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentWidth()
Gibt die inhärente Höhe des Bildes in Pixeln zurück.
Zurücksenden
Integer
: Die inhärente Breite in Pixeln.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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.
Zurücksenden
String
: Der Name der Funktion.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
Gibt das Tabellenblatt zurück, auf dem das Bild zu sehen ist
// 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()); }
Zurücksenden
Sheet
: Das Tabellenblatt, auf dem das Bild zu sehen ist.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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 mithilfe einer API mithilfe einer URL eingefügt wurde, wird mit dieser Methode die URL zurückgegeben, die beim Einfügen des Bildes angegeben wurde.
Zurücksenden
String
: Die Bild-URL, falls verfügbar; gibt null
zurück, wenn das Bild nicht verfügbar ist oder keine Quell-URL hat.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Gibt die tatsächliche Breite des 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()); }
Zurücksenden
Integer
: Die Breite des Bildes in Pixeln.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Das Bild wird aus der Tabelle gelöscht. Bei allen weiteren Vorgängen am Bild tritt ein Skriptfehler auf.
// Deletes all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { images[i].remove(); }
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(blob)
Ersetzt dieses Bild durch das von der angegebenen BlobSource
angegebene. Die maximal unterstützte Blob-Größe beträgt 2 MB.
Parameter
Name | Typ | Beschreibung |
---|---|---|
blob | BlobSource | Das neue Bild als Blob. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(url)
Ersetzt dieses Bild durch das Bild aus der angegebenen URL.
Parameter
Name | Typ | Beschreibung |
---|---|---|
url | String | Die URL des neuen Bilds. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetSize()
Setzt dieses Bild auf seine ursprünglichen Abmessungen zurück.
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
Legt die Alt-Textbeschreibung für dieses Bild fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
description | String | Die neue Alt-Textbeschreibung für das Bild. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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
Name | Typ | Beschreibung |
---|---|---|
title | String | Der neue Alt-Texttitel für das Bild. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellXOffset(offset)
Legt den horizontalen Pixelversatz gegenüber der Ankerzelle fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Integer | Das neue horizontale Pixel-Offset. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellYOffset(offset)
Legt den vertikalen Pixelversatz gegenüber der Ankerzelle fest.
Parameter
Name | Typ | Beschreibung |
---|---|---|
offset | Integer | Der neue vertikale Pixelversatz. |
Zurücksenden
OverGridImage
: Dieses Bild ist zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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. |
Zurücksenden
OverGridImage
: Das Bild zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
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. |
Zurücksenden
OverGridImage
: Das Bild zum Verketten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets