Class OverGridImage

ÜberRasterBild

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

Methoden

MethodeRückgabetypKurzbeschreibung
assignScript(functionName)OverGridImageWeisen Sie diesem Bild die Funktion mit dem angegebenen Funktionsnamen zu.
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.
getAnchorCell()RangeGibt die Zelle zurück, an der ein Bild verankert ist.
getAnchorCellXOffset()IntegerGibt den horizontalen Pixeloffset von der Ankerzelle zurück.
getAnchorCellYOffset()IntegerGibt den vertikalen Pixeloffset von der Ankerzelle zurück.
getHeight()IntegerDie tatsächliche Höhe dieses Bilds in Pixeln.
getInherentHeight()IntegerDie Höhe dieses Bilds in Pixeln.
getInherentWidth()IntegerDie Höhe dieses Bilds in Pixeln.
getScript()StringGibt den Namen der Funktion zurück, die diesem Bild zugewiesen ist.
getSheet()SheetGibt das Tabellenblatt zurück, in dem sich dieses Bild befindet.
getUrl()StringRuft die Quell-URL des Bildes ab. Wenn die URL nicht verfügbar ist, wird null zurückgegeben.
getWidth()IntegerDie tatsächliche Breite dieses Bilds in Pixeln.
remove()voidLöscht dieses Bild aus der Tabelle.
replace(blob)OverGridImageErsetzt dieses Bild durch das mit BlobSource angegebene.
replace(url)OverGridImageErsetzt dieses Bild durch das Bild von der angegebenen URL.
resetSize()OverGridImageDas Bild wird auf seine ursprünglichen Abmessungen zurückgesetzt.
setAltTextDescription(description)OverGridImageHier wird der Alt-Text für dieses Bild festgelegt.
setAltTextTitle(title)OverGridImageLegt den Titel des Alt-Texts für dieses Bild fest.
setAnchorCell(cell)OverGridImageLegt die Zelle fest, an 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)OverGridImageHiermit wird die tatsächliche Höhe dieses Bilds in Pixeln festgelegt.
setWidth(width)OverGridImageHiermit wird die tatsächliche Breite dieses Bilds in Pixeln festgelegt.

Detaillierte Dokumentation

assignScript(functionName)

Weisen Sie diesem Bild die Funktion mit dem angegebenen Funktionsnamen zu.

Parameter

NameTypBeschreibung
functionNameStringDer Name der angegebenen Funktion. Es muss sich um eine öffentliche Funktion der obersten Ebene handeln, die nicht auf einen Unterstrich endet, z. B. privateFunction_.

Rückflug

OverGridImage – 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

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

getAnchorCell()

Gibt die Zelle zurück, an der ein Bild verankert ist.

Rückflug

Range: Die Ankerzelle.

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

getAnchorCellXOffset()

Gibt den horizontalen Pixeloffset von der Ankerzelle zurück.

Rückflug

Integer – Der horizontale Pixelversatz.

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

getAnchorCellYOffset()

Gibt den vertikalen Pixeloffset von der Ankerzelle zurück.

Rückflug

Integer – vertikaler Pixeloffset

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

getHeight()

Die tatsächliche Höhe dieses Bilds in Pixeln.

// 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());
}

Rückflug

Integer: Die Höhe des Bilds in Pixeln.

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

getInherentHeight()

Die Höhe dieses Bilds in Pixeln.

Rückflug

Integer – Die Höhe in Pixeln.

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

getInherentWidth()

Die Höhe dieses Bilds in Pixeln.

Rückflug

Integer: Die Breite in Pixeln.

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

getScript()

Gibt den Namen der Funktion zurück, die diesem Bild zugewiesen ist.

Rückflug

String: Der Name der Funktion.

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

getSheet()

Gibt das Tabellenblatt zurück, in dem sich dieses Bild befindet.

// 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());
}

Rückflug

Sheet: Das Tabellenblatt, auf dem das Bild angezeigt wird.

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

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

getWidth()

Die tatsächliche Breite dieses Bilds in Pixeln.

// 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());
}

Rückflug

Integer: Die Breite des Bilds in Pixeln.

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

remove()

Löscht dieses Bild aus der Tabelle. Alle weiteren Vorgänge am Bild führen zu einem Scriptfehler.

// Deletes all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var i = 0; i < images.length; i++) {
  images[i].remove();
}

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

replace(blob)

Ersetzt dieses Bild durch das mit BlobSource angegebene. Blobs dürfen maximal 2 MB groß sein.

Parameter

NameTypBeschreibung
blobBlobSourceDas neue Image als Blob.

Rückflug

OverGridImage – 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

replace(url)

Ersetzt dieses Bild durch das Bild von der angegebenen URL.

Parameter

NameTypBeschreibung
urlStringDie URL des neuen Bildes.

Rückflug

OverGridImage – 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

resetSize()

Das Bild wird auf seine ursprünglichen Abmessungen zurückgesetzt.

Rückflug

OverGridImage – 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

setAltTextDescription(description)

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

Parameter

NameTypBeschreibung
descriptionStringDer neue Alt-Text für das Bild.

Rückflug

OverGridImage – 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

OverGridImage – 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

setAnchorCell(cell)

Legt die Zelle fest, an der ein Bild verankert ist.

Parameter

NameTypBeschreibung
cellRangeDie neue Ankerzelle.

Rückflug

OverGridImage – 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

setAnchorCellXOffset(offset)

Legt den horizontalen Pixelversatz von der Ankerzelle fest.

Parameter

NameTypBeschreibung
offsetIntegerDer neue horizontale Pixelversatz.

Rückflug

OverGridImage – 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

setAnchorCellYOffset(offset)

Legt den vertikalen Pixelversatz von der Ankerzelle fest.

Parameter

NameTypBeschreibung
offsetIntegerDer neue vertikale Pixel-Offset.

Rückflug

OverGridImage – 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

setHeight(height)

Hiermit wird die tatsächliche Höhe dieses Bilds in Pixeln festgelegt.

Parameter

NameTypBeschreibung
heightIntegerDie gewünschte Höhe in Pixeln.

Rückflug

OverGridImage – das Bild für die 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

setWidth(width)

Hiermit wird die tatsächliche Breite dieses Bilds in Pixeln festgelegt.

Parameter

NameTypBeschreibung
widthIntegerDie gewünschte Breite in Pixeln.

Rückflug

OverGridImage – das Bild für die 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