Class Drawing

Zeichnung

Stellt eine Zeichnung auf einem Tabellenblatt in einer Tabelle dar.

Methoden

MethodeRückgabetypKurzbeschreibung
getContainerInfo()ContainerInfoRuft Informationen dazu ab, wo sich die Zeichnung im Tabellenblatt befindet.
getHeight()IntegerGibt die tatsächliche Höhe dieser Zeichnung in Pixeln zurück.
getOnAction()String|nullGibt 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 dieser 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 dazu ab, wo sich die Zeichnung im Tabellenblatt befindet.

Rückflug

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

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 dieser Zeichnung in Pixeln zurück.

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

Rückflug

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

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.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Rückflug

String|null: Der mit dieser Zeichnung verknüpfte Makroname.

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

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

Rückflug

Sheet: Das Blatt, auf dem die Zeichnung zu sehen ist.

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 dieser Zeichnung in Pixeln zurück.

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

Rückflug

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

getZIndex()

Gibt den Z-Index dieser Zeichnung zurück.

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

Rückflug

Number: Z-Index dieser Zeichnung.

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

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

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

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

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 fest, an der die Zeichnung auf dem Tabellenblatt angezeigt wird. Die Indexe für die Ankerzeile und ‑spalte sind 1-basiert.

Parameter

NameTypBeschreibung
anchorRowPosIntegerDie Oberseite der Zeichnung wird in dieser Zeile verankert.
anchorColPosIntegerDie Oberseite der Zeichnung wird in dieser Spalte verankert.
offsetXIntegerDer horizontale Offset von der Zellenecke in Pixeln.
offsetYIntegerDer vertikale Offset von der Zellenecke in Pixeln.

Rückflug

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

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

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

setZIndex(zIndex)

Legt den Z-Index dieser Zeichnung fest.

Parameter

NameTypBeschreibung
zIndexNumberZ-Index dieser Zeichnung.

Rückflug

Drawing – Diese Zeichnung zur Verkettung.