Class OverGridImage

OverGrid-Bild

Stellt ein Bild über dem Raster in einer Tabelle dar

Methoden

MethodeRückgabetypKurzbeschreibung
assignScript(functionName)OverGridImageWeist diesem Image die Funktion mit dem angegebenen Funktionsnamen zu.
getAltTextDescription()StringGibt die Alt-Textbeschreibung für dieses Bild zurück.
getAltTextTitle()StringGibt den Alt-Texttitel für dieses Bild zurück.
getAnchorCell()RangeGibt die Zelle zurück, in der ein Bild verankert ist.
getAnchorCellXOffset()IntegerGibt den horizontalen Pixelversatz von der Ankerzelle zurück.
getAnchorCellYOffset()IntegerGibt den vertikalen Pixelversatz von der Ankerzelle zurück.
getHeight()IntegerGibt die tatsächliche Höhe des Bildes in Pixeln zurück.
getInherentHeight()IntegerGibt die inhärente Höhe des Bildes in Pixeln zurück.
getInherentWidth()IntegerGibt die inhärente Höhe des Bildes in Pixeln zurück.
getScript()StringGibt den Namen der Funktion zurück, die diesem Bild zugewiesen ist.
getSheet()SheetGibt das Tabellenblatt zurück, auf dem das Bild zu sehen ist
getUrl()StringRuft die Quell-URL des Bildes ab. Gibt null zurück, wenn die URL nicht verfügbar ist.
getWidth()IntegerGibt die tatsächliche Breite des Bildes in Pixeln zurück.
remove()voidDas Bild wird aus der Tabelle gelöscht.
replace(blob)OverGridImageErsetzt dieses Bild durch das von der angegebenen BlobSource angegebene.
replace(url)OverGridImageErsetzt dieses Bild durch das Bild aus der angegebenen URL.
resetSize()OverGridImageSetzt dieses Bild auf seine ursprünglichen Abmessungen zurück.
setAltTextDescription(description)OverGridImageLegt die Alt-Textbeschreibung für dieses Bild fest.
setAltTextTitle(title)OverGridImageLegt den Titel des Alt-Texts für dieses Bild fest.
setAnchorCell(cell)OverGridImageLegt die Zelle fest, in der ein Bild verankert ist.
setAnchorCellXOffset(offset)OverGridImageLegt den horizontalen Pixelversatz gegenüber der Ankerzelle fest.
setAnchorCellYOffset(offset)OverGridImageLegt den vertikalen Pixelversatz gegenüber der Ankerzelle fest.
setHeight(height)OverGridImageLegt die tatsächliche Höhe des Bildes in Pixeln fest.
setWidth(width)OverGridImageLegt die tatsächliche Breite des Bildes in Pixeln fest.

Detaillierte Dokumentation

assignScript(functionName)

Weist diesem Image die Funktion mit dem angegebenen Funktionsnamen zu.

Parameter

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

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

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

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

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

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

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

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

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

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