Class OverGridImage

OverGridImage

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

Methoden

MethodeRückgabetypKurzbeschreibung
assignScript(functionName)OverGridImageWeist diesem Bild die Funktion mit dem angegebenen Funktionsnamen zu.
getAltTextDescription()StringGibt die Alt-Textbeschreibung 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 Pixelversatz zur Ankerzelle zurück.
getAnchorCellYOffset()IntegerGibt den vertikalen Pixelversatz zur 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.
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 Bild, das in der angegebenen BlobSource angegeben ist.
replace(url)OverGridImageErsetzt dieses Bild durch das Bild der angegebenen URL.
resetSize()OverGridImageSetzt dieses 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-Text-Titel 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 dieses Bildes in Pixeln fest.
setWidth(width)OverGridImageLegt die tatsächliche Breite dieses Bildes in Pixeln fest.

Detaillierte Dokumentation

assignScript(functionName)

Weist diesem Bild die Funktion mit dem angegebenen Funktionsnamen zu.

Parameter

NameTypBeschreibung
functionNameStringDer Name der angegebenen Funktion. Dies muss eine öffentliche oberste Ebene sein und nicht eine, die mit einem Unterstrich wie privateFunction_ endet.

Rückflug

OverGridImage: Dieses Bild zur 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

getAltTextDescription()

Gibt die Alt-Textbeschreibung für dieses Bild zurück

Rückflug

String: Die Beschreibung des Alt-Textes.

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 Alt-Text-Titel für dieses Bild zurück.

Rückflug

String: Der Titel des Alt-Textes.

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.

Rückflug

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 zur Ankerzelle zurück.

Rückflug

Integer: Der horizontale Pixelversatz.

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 zur Ankerzelle zurück.

Rückflug

Integer: Der 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 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());
}

Rückflug

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.

Rückflug

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.

Rückflug

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.

Rückflug

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

Rückflug

Sheet: Das Tabellenblatt, auf dem das Bild erscheint.

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 mithilfe einer API eingefügt haben, gibt diese Methode die URL zurück, die beim Einfügen des Bildes angegeben wurde.

Rückflug

String: die Bild-URL, falls verfügbar gibt null zurück, wenn das Bild nicht verfügbar ist oder nicht eine Quell-URL haben.

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

Rückflug

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. Jede weitere Operation an dem Bild führt zu einem Skript. Fehler. 

// 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 Bild, das in der angegebenen BlobSource angegeben ist. Das Maximum unterstützte Blob-Größe ist 2 MB.

Parameter

NameTypBeschreibung
blobBlobSourceDas neue Bild als Blob.

Rückflug

OverGridImage: Dieses Bild zur 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

replace(url)

Ersetzt dieses Bild durch das Bild der angegebenen URL.

Parameter

NameTypBeschreibung
urlStringDie URL des neuen Bilds.

Rückflug

OverGridImage: Dieses Bild zur 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

resetSize()

Setzt dieses Bild auf seine ursprünglichen Abmessungen zurück.

Rückflug

OverGridImage: Dieses Bild zur 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

setAltTextDescription(description)

Legt die Alt-Text-Beschreibung für dieses Bild fest.

Parameter

NameTypBeschreibung
descriptionStringDie neue Alt-Textbeschreibung für das Bild.

Rückflug

OverGridImage: Dieses Bild zur 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

setAltTextTitle(title)

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

Parameter

NameTypBeschreibung
titleStringDer neue Titel des Alt-Textes für das Bild.

Rückflug

OverGridImage: Dieses Bild zur 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

setAnchorCell(cell)

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

Parameter

NameTypBeschreibung
cellRangeDie neue Ankerzelle.

Rückflug

OverGridImage: Dieses Bild zur 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

setAnchorCellXOffset(offset)

Legt den horizontalen Pixelversatz von der Ankerzelle fest.

Parameter

NameTypBeschreibung
offsetIntegerDer neue horizontale Pixelversatz.

Rückflug

OverGridImage: Dieses Bild zur 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

setAnchorCellYOffset(offset)

Legt den vertikalen Pixelversatz von der Ankerzelle fest.

Parameter

NameTypBeschreibung
offsetIntegerDer neue vertikale Pixelversatz.

Rückflug

OverGridImage: Dieses Bild zur 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

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

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 dieses Bildes in Pixeln fest.

Parameter

NameTypBeschreibung
widthIntegerDie gewünschte Breite in Pixeln.

Rückflug

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