Class OverGridImage

OverGridImage

Stellt ein Bild über dem Raster in einer Tabellenkalkulation dar.

Methoden

MethodeRückgabetypKurzbeschreibung
assignScript(functionName)OverGridImageWeist diesem Image die Funktion mit dem angegebenen Funktionsnamen zu.
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.
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 dieses Bildes in Pixeln an.
getInherentHeight()IntegerGibt die inhärente Höhe dieses Bildes in Pixeln zurück.
getInherentWidth()IntegerGibt die inhärente Höhe dieses 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 dieses Bild angezeigt wird.
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 dieses Bildes in Pixeln zurück.
remove()voidLöscht dieses Bild aus der Tabelle.
replace(blob)OverGridImageErsetzt dieses Bild durch das im angegebenen BlobSource angegebene Bild.
replace(url)OverGridImageErsetzt dieses Bild durch das Bild der angegebenen URL.
resetSize()OverGridImageSetzt das Bild auf seine ursprünglichen Abmessungen zurück.
setAltTextDescription(description)OverGridImageLegt die Alt-Text-Beschreibung für dieses Bild fest.
setAltTextTitle(title)OverGridImageLegt den Alt-Texttitel für dieses Bild fest.
setAnchorCell(cell)OverGridImageLegt die Zelle fest, in der ein Bild verankert ist.
setAnchorCellXOffset(offset)OverGridImageLegt den horizontalen Pixelversatz von der Ankerzelle fest.
setAnchorCellYOffset(offset)OverGridImageLegt den vertikalen Pixelversatz von 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. 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

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

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

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

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

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

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

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

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

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