Eine Zeichnung über einem Tabellenblatt in einer Tabelle.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getContainerInfo() | ContainerInfo | Ruft Informationen zur Position der Zeichnung im Tabellenblatt ab. |
getHeight() | Integer | Gibt die tatsächliche Höhe dieser Zeichnung in Pixeln an. |
getOnAction() | String | Gibt den Namen des an diese Zeichnung angehängten Makros zurück |
getSheet() | Sheet | Gibt das Tabellenblatt zurück, auf dem diese Zeichnung zu sehen ist. |
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 | Legt die tatsächliche Höhe dieser Zeichnung in Pixeln fest. |
setOnAction(macroName) | Drawing | Weist dieser Zeichnung eine Makrofunktion zu. |
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY) | Drawing | Legt die Position der Zeichnung auf dem Tabellenblatt fest. |
setWidth(width) | Drawing | Legt die tatsächliche Breite dieser Zeichnung in Pixeln fest. |
setZIndex(zIndex) | Drawing | Legt 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
Name | Typ | Beschreibung |
---|---|---|
height | Integer | Die 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
Name | Typ | Beschreibung |
---|---|---|
macroName | String | Name 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
Name | Typ | Beschreibung |
---|---|---|
anchorRowPos | Integer | In dieser Zeile ist die obere Seite der Zeichnung verankert. |
anchorColPos | Integer | Die obere Seite der Zeichnung ist in dieser Spalte verankert. |
offsetX | Integer | Der horizontale Versatz von der Ecke der Zelle in Pixeln. |
offsetY | Integer | Der 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
Name | Typ | Beschreibung |
---|---|---|
width | Integer | Die 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
Name | Typ | Beschreibung |
---|---|---|
zIndex | Number | Z-Index dieser Zeichnung. |
Rückflug
Drawing
: Diese Zeichnung zur Verkettung.