Stellt eine Zeichnung auf einem Tabellenblatt in einer Tabelle dar.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
get | Container | Ruft Informationen dazu ab, wo sich die Zeichnung im Tabellenblatt befindet. |
get | Integer | Gibt die tatsächliche Höhe dieser Zeichnung in Pixeln zurück. |
get | String|null | Gibt den Namen des Makros zurück, das an diese Zeichnung angehängt ist. |
get | Sheet | Gibt das Tabellenblatt zurück, auf dem diese Zeichnung angezeigt wird. |
get | Integer | Gibt die tatsächliche Breite dieser Zeichnung in Pixeln zurück. |
get | Number | Gibt den Z-Index dieser Zeichnung zurück. |
remove() | void | Löscht diese Zeichnung aus der Tabelle. |
set | Drawing | Legt die tatsächliche Höhe dieser Zeichnung in Pixeln fest. |
set | Drawing | Weist dieser Zeichnung eine Makrofunktion zu. |
set | Drawing | Legt die Position fest, an der die Zeichnung auf dem Tabellenblatt angezeigt wird. |
set | Drawing | Legt die tatsächliche Breite dieser Zeichnung in Pixeln fest. |
set | Drawing | Legt den Z-Index dieser Zeichnung fest. |
Detaillierte Dokumentation
get Container Info()
Ruft Informationen dazu ab, wo sich die Zeichnung im Tabellenblatt befindet.
Rückflug
Container: 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
get Height()
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
get On Action()
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
get Sheet()
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
get Width()
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
get ZIndex()
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
set Height(height)
Legt die tatsächliche Höhe dieser Zeichnung in Pixeln fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
height | Integer | Die 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
set On Action(macroName)
Weist dieser Zeichnung eine Makrofunktion zu.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
macro | String | Name der Makrofunktion. |
Rückflug
Drawing – Diese Zeichnung zur Verkettung.
set Position(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
| Name | Typ | Beschreibung |
|---|---|---|
anchor | Integer | Die Oberseite der Zeichnung wird in dieser Zeile verankert. |
anchor | Integer | Die Oberseite der Zeichnung wird in dieser Spalte verankert. |
offsetX | Integer | Der horizontale Offset von der Zellenecke in Pixeln. |
offsetY | Integer | Der 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
set Width(width)
Legt die tatsächliche Breite dieser Zeichnung in Pixeln fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
width | Integer | Die 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
set ZIndex(zIndex)
Legt den Z-Index dieser Zeichnung fest.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
zIndex | Number | Z-Index dieser Zeichnung. |
Rückflug
Drawing – Diese Zeichnung zur Verkettung.