Class Drawing

Zeichnung

Stellt eine Zeichnung auf einem Tabellenblatt in einer Tabellenkalkulation dar.

Methoden

MethodeRückgabetypKurzbeschreibung
getContainerInfo()ContainerInfoRuft Informationen zur Position der Zeichnung im Tabellenblatt ab.
getHeight()IntegerGibt die tatsächliche Höhe dieser Zeichnung in Pixeln an.
getOnAction()StringGibt den Namen des Makros zurück, das an diese Zeichnung angehängt ist
getSheet()SheetGibt das Tabellenblatt zurück, auf dem diese Zeichnung angezeigt wird.
getWidth()IntegerGibt die tatsächliche Breite dieser Zeichnung in Pixeln zurück.
getZIndex()NumberGibt den Z-Index dieser Zeichnung zurück.
remove()voidLöscht diese Zeichnung aus der Tabelle.
setHeight(height)DrawingLegt die tatsächliche Höhe der Zeichnung in Pixeln fest.
setOnAction(macroName)DrawingWeist dieser Zeichnung eine Makrofunktion zu.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingLegt die Position fest, an der die Zeichnung auf dem Tabellenblatt angezeigt wird.
setWidth(width)DrawingLegt die tatsächliche Breite dieser Zeichnung in Pixeln fest.
setZIndex(zIndex)DrawingLegt den Z-Index dieser Zeichnung fest.

Detaillierte Dokumentation

getContainerInfo()

Ruft Informationen zur Position der Zeichnung im Tabellenblatt ab.

Return

ContainerInfo: Ein Objekt, das die Containerposition der Zeichnung enthält.

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 dieser Zeichnung in Pixeln an.

// Logs the height of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getHeight());
}

Return

Integer: Die Höhe der Zeichnung 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

getOnAction()

Gibt den Namen des Makros zurück, das an diese Zeichnung angehängt ist

// Logs the macro name of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Return

String: Der Makroname, der mit dieser Zeichnung verknüpft ist.

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 diese Zeichnung angezeigt wird.

// Logs the parent sheet of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

Return

Sheet: Das Tabellenblatt, auf dem die Zeichnung 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

getWidth()

Gibt die tatsächliche Breite dieser Zeichnung in Pixeln zurück.

// Logs the width of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getWidth());
}

Return

Integer: Die Breite der Zeichnung 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

getZIndex()

Gibt den Z-Index dieser Zeichnung zurück.

// Logs the z-index of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

Return

Number: Z-Index dieser Zeichnung.

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 diese Zeichnung aus der Tabelle. Jeder weitere Vorgang an der Zeichnung führt zu einem Skriptfehler.

// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[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

setHeight(height)

Legt die tatsächliche Höhe der Zeichnung in Pixeln fest.

Parameter

NameTypBeschreibung
heightIntegerDie gewünschte Höhe in Pixeln.

Return

Drawing: Diese Zeichnung 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

setOnAction(macroName)

Weist dieser Zeichnung eine Makrofunktion zu.

Parameter

NameTypBeschreibung
macroNameStringName der Makrofunktion.

Return

Drawing: Diese Zeichnung für die Verkettung.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Legt die Position fest, an der die Zeichnung auf dem Tabellenblatt angezeigt wird. Die Positionsindexe für Ankerzeilen und -spalten sind 1indexiert.

Parameter

NameTypBeschreibung
anchorRowPosIntegerDie obere Seite der Zeichnung ist in dieser Zeile verankert.
anchorColPosIntegerDie obere Seite der Zeichnung ist in dieser Spalte verankert.
offsetXIntegerDer horizontale Abstand von der Ecke der Zelle in Pixeln.
offsetYIntegerDer vertikale Abstand von der Zellenecke in Pixeln.

Return

Drawing: Diese Zeichnung 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 dieser Zeichnung in Pixeln fest.

Parameter

NameTypBeschreibung
widthIntegerDie gewünschte Breite in Pixeln.

Return

Drawing: Diese Zeichnung 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

setZIndex(zIndex)

Legt den Z-Index dieser Zeichnung fest.

Parameter

NameTypBeschreibung
zIndexNumberZ-Index dieser Zeichnung.

Return

Drawing: Diese Zeichnung für die Verkettung.