Class OverGridImage

OverGridImage

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

Methoden

MethodeRückgabetypKurzbeschreibung
assignScript(functionName)OverGridImageWeist dem Bild die Funktion mit dem angegebenen Funktionsnamen zu.
getAltTextDescription()StringGibt die Alt-Text-Beschreibung für dieses Bild zurück.
getAltTextTitle()StringGibt den Alt-Text-Titel für dieses Bild zurück.
getAnchorCell()RangeGibt die Zelle zurück, in der ein Bild verankert ist.
getAnchorCellXOffset()IntegerGibt den horizontalen Pixel-Offset von der Ankerzelle zurück.
getAnchorCellYOffset()IntegerGibt den vertikalen Pixel-Offset von der Ankerzelle zurück.
getHeight()IntegerGibt die tatsächliche Höhe dieses Bildes in Pixeln zurück.
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.
getWidth()IntegerGibt die tatsächliche Breite dieses Bilds in Pixeln zurück.
remove()voidLöscht dieses Bild aus der Tabelle.
replace(blob)OverGridImageErsetzt dieses Bild durch das Bild, das durch den bereitgestellten BlobSource angegeben wird.
replace(url)OverGridImageErsetzt dieses Bild durch das Bild von der angegebenen URL.
resetSize()OverGridImageSetzt die Abmessungen dieses Bildes auf die ursprünglichen Werte zurück.
setAltTextDescription(description)OverGridImageLegt den Alt-Text für dieses Bild fest.
setAltTextTitle(title)OverGridImageLegt den Alt-Text-Titel für dieses Bild fest.
setAnchorCell(cell)OverGridImageLegt die Zelle fest, in der ein Bild verankert wird.
setAnchorCellXOffset(offset)OverGridImageLegt den horizontalen Pixel-Offset von der Ankerzelle fest.
setAnchorCellYOffset(offset)OverGridImageLegt den vertikalen Pixel-Offset von der Ankerzelle fest.
setHeight(height)OverGridImageLegt die tatsächliche Höhe dieses Bildes in Pixeln fest.
setWidth(width)OverGridImageLegt die tatsächliche Breite dieses Bilds in Pixeln fest.

Detaillierte Dokumentation

assignScript(functionName)

Weist dem Bild die Funktion mit dem angegebenen Funktionsnamen zu.

Parameter

NameTypBeschreibung
functionNameStringDer Name der angegebenen Funktion. Dies muss eine öffentliche Funktion der obersten Ebene sein, die nicht mit einem Unterstrich endet, z. B. privateFunction_.

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 – Die Beschreibung des Alt-Texts.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAltTextTitle()

Gibt den Alt-Text-Titel für dieses Bild zurück.

Rückflug

String – Der Titel des Alt-Texts.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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.

Rückflug

Range – Die Ankerzelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCellXOffset()

Gibt den horizontalen Pixel-Offset von der Ankerzelle zurück.

Rückflug

Integer – Das horizontale Pixel-Offset.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getAnchorCellYOffset()

Gibt den vertikalen Pixel-Offset von der Ankerzelle zurück.

Rückflug

Integer – Das vertikale Pixel-Offset.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getHeight()

Gibt die tatsächliche Höhe dieses Bildes in Pixeln zurück. 

// Logs the height of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

Rückflug

Integer: Die Höhe des Bildes in Pixeln.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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.

Rückflug

Integer: Die inhärente Höhe in Pixeln.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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.

Rückflug

Integer: Die inhärente Breite in Pixeln.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getWidth()

Gibt die tatsächliche Breite dieses Bilds in Pixeln zurück. 

// Logs the width of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

Rückflug

Integer: Die Breite des Bildes in Pixeln.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  images[i].remove();
}

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

replace(blob)

Ersetzt dieses Bild durch das Bild, das durch den bereitgestellten BlobSource angegeben wird. Die maximal unterstützte Blob-Größe beträgt 2 MB.

Parameter

NameTypBeschreibung
blobBlobSourceDas neue Bild als Blob.

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

resetSize()

Setzt die Abmessungen dieses Bildes auf die ursprünglichen Werte zurück.

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextDescription(description)

Legt den Alt-Text für dieses Bild fest.

Parameter

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

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextTitle(title)

Legt den Alt-Text-Titel 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAnchorCell(cell)

Legt die Zelle fest, in der ein Bild verankert wird.

Parameter

NameTypBeschreibung
cellRangeDie neue Ankerzelle.

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAnchorCellXOffset(offset)

Legt den horizontalen Pixel-Offset von der Ankerzelle fest.

Parameter

NameTypBeschreibung
offsetIntegerDer neue horizontale Pixel-Offset.

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAnchorCellYOffset(offset)

Legt den vertikalen Pixel-Offset von der Ankerzelle fest.

Parameter

NameTypBeschreibung
offsetIntegerDer neue vertikale Pixel-Offset.

Rückflug

OverGridImage: Dieses Bild zur Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeight(height)

Legt die tatsächliche Höhe dieses Bildes in Pixeln fest.

Parameter

NameTypBeschreibung
heightIntegerDie gewünschte Höhe in Pixeln.

Rückflug

OverGridImage – Das Bild für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWidth(width)

Legt die tatsächliche Breite dieses Bilds in Pixeln fest.

Parameter

NameTypBeschreibung
widthIntegerDie gewünschte Breite in Pixeln.

Rückflug

OverGridImage – Das Bild für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Eingestellte Methoden