Class Drawing

Zeichnen

Stellt eine Zeichnung auf einem Tabellenblatt dar.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getContainerInfo()	ContainerInfo	Hier erfahren Sie, wo sich die Zeichnung im Tabellenblatt befindet.
getHeight()	Integer	Gibt die tatsächliche Höhe dieser Zeichnung in Pixeln zurück.
getOnAction()	String	Gibt den Namen des Makros zurück, das mit dieser Zeichnung verknüpft ist.
getSheet()	Sheet	Gibt das Tabellenblatt zurück, in dem sich diese Zeichnung befindet.
getWidth()	Integer	Gibt die tatsächliche Breite dieser Zeichnung in Pixeln zurück.
getZIndex()	Number	Gibt den Z-Index dieser Zeichnung zurück.
remove()	void	Löscht diese Zeichnung aus der Tabelle.
setHeight(height)	Drawing	Hiermit wird die tatsächliche Höhe dieser Zeichnung in Pixeln festgelegt.
setOnAction(macroName)	Drawing	Hiermit wird dieser Zeichnung eine Makrofunktion zugewiesen.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Drawing	Hier legen Sie fest, wo die Zeichnung auf dem Blatt angezeigt wird.
setWidth(width)	Drawing	Hiermit wird die tatsächliche Breite dieser Zeichnung in Pixeln festgelegt.
setZIndex(zIndex)	Drawing	Hiermit wird der Z-Index dieser Zeichnung festgelegt.

Detaillierte Dokumentation

getContainerInfo()

Hier erfahren Sie, wo sich die Zeichnung im Tabellenblatt befindet.

Rückflug

ContainerInfo: Ein Objekt mit der Containerposition der Zeichnung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 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, erfordern eine Autorisierung für einen oder mehrere 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 mit dieser Zeichnung verknüpft 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: Der Makroname, der mit dieser Zeichnung verknüpft ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

getSheet()

Gibt das Tabellenblatt zurück, in dem sich diese Zeichnung befindet.

// 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 Tabellenblatt, auf dem die Zeichnung angezeigt wird.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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
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, erfordern eine Autorisierung für einen oder mehrere 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.
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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

remove()

Löscht diese Zeichnung aus der Tabelle. Alle weiteren Vorgänge an der Zeichnung führen zu einem Scriptfehler.

// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setHeight(height)

Hiermit wird die tatsächliche Höhe dieser Zeichnung in Pixeln festgelegt.

Parameter

Name	Typ	Beschreibung
height	Integer	Die gewünschte Höhe in Pixeln.

Rückflug

Drawing – Diese Zeichnung, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setOnAction(macroName)

Hiermit wird dieser Zeichnung eine Makrofunktion zugewiesen.

Parameter

Name	Typ	Beschreibung
macroName	String	Name der Makrofunktion.

Rückflug

Drawing – Diese Zeichnung, für die Verkettung.

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Hier legen Sie fest, wo die Zeichnung auf dem Blatt angezeigt wird. Die Zeilen- und Spaltenpositionen des Ankers beginnen mit 1.

Parameter

Name	Typ	Beschreibung
anchorRowPos	Integer	Die Oberseite der Zeichnung ist in dieser Zeile verankert.
anchorColPos	Integer	Die Oberseite der Zeichnung ist an dieser Spalte verankert.
offsetX	Integer	Der horizontale Abstand von der Zellenecke in Pixeln.
offsetY	Integer	Der vertikale Offset von der Zellenecke in Pixeln.

Rückflug

Drawing – Diese Zeichnung, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setWidth(width)

Hiermit wird die tatsächliche Breite dieser Zeichnung in Pixeln festgelegt.

Parameter

Name	Typ	Beschreibung
width	Integer	Die gewünschte Breite in Pixeln.

Rückflug

Drawing – Diese Zeichnung, für die Verkettung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

---

setZIndex(zIndex)

Hiermit wird der Z-Index dieser Zeichnung festgelegt.

Parameter

Name	Typ	Beschreibung
zIndex	Number	Z-Index dieser Zeichnung.

Rückflug

Drawing – Diese Zeichnung, für die Verkettung.