Class Drawing

Zeichnung

Eine Zeichnung über einem Tabellenblatt in einer Tabelle.

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 an diese Zeichnung angehängten Makros zurück
getSheet()SheetGibt das Tabellenblatt zurück, auf dem diese Zeichnung zu sehen ist.
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 dieser Zeichnung in Pixeln fest.
setOnAction(macroName)DrawingWeist dieser Zeichnung eine Makrofunktion zu.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingLegt die Position der Zeichnung auf dem Tabellenblatt fest.
setWidth(width)DrawingLegt die tatsächliche Breite dieser Zeichnung in Pixeln fest.
setZIndex(zIndex)DrawingLegt den Z-Index der Zeichnung fest.

Detaillierte Dokumentation

getContainerInfo()

Ruft Informationen zur Position der Zeichnung im Tabellenblatt ab.

Rückflug

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

Rückflug

Integer: 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 an diese Zeichnung angehängten Makros zurück

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

Rückflug

String: Der an diese Zeichnung angehängte Makroname.

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 zu sehen ist.

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

Rückflug

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

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

Rückflug

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

Rückflug

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. Jede weitere Operation an der Zeichnung führt zu einer 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 dieser Zeichnung in Pixeln fest.

Parameter

NameTypBeschreibung
heightIntegerDie gewünschte Höhe in Pixeln.

Rückflug

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

setOnAction(macroName)

Weist dieser Zeichnung eine Makrofunktion zu.

Parameter

NameTypBeschreibung
macroNameStringName der Makrofunktion.

Rückflug

Drawing: Diese Zeichnung zur Verkettung.


setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Legt die Position der Zeichnung auf dem Tabellenblatt fest. Die Position der Ankerzeile und -spalte Indizes sind 1-indexiert.

Parameter

NameTypBeschreibung
anchorRowPosIntegerIn dieser Zeile ist die obere Seite der Zeichnung verankert.
anchorColPosIntegerDie obere Seite der Zeichnung ist in dieser Spalte verankert.
offsetXIntegerDer horizontale Versatz von der Ecke der Zelle in Pixeln.
offsetYIntegerDer vertikale Versatz von der Ecke der Zelle in Pixeln.

Rückflug

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

setWidth(width)

Legt die tatsächliche Breite dieser Zeichnung in Pixeln fest.

Parameter

NameTypBeschreibung
widthIntegerDie gewünschte Breite in Pixeln.

Rückflug

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

setZIndex(zIndex)

Legt den Z-Index der Zeichnung fest.

Parameter

NameTypBeschreibung
zIndexNumberZ-Index dieser Zeichnung.

Rückflug

Drawing: Diese Zeichnung zur Verkettung.