代表試算表工作表上的繪圖。
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
get | Container | 取得繪圖在工作表中的位置資訊。 |
get | Integer | 傳回這個繪圖的實際高度 (以像素為單位)。 |
get | String|null | 傳回附加至此繪圖的巨集名稱。 |
get | Sheet | 傳回這個繪圖所在的試算表。 |
get | Integer | 傳回這個繪圖的實際寬度 (以像素為單位)。 |
get | Number | 傳回這個繪圖的 z-index。 |
remove() | void | 從試算表中刪除這項繪圖。 |
set | Drawing | 以像素為單位設定此繪圖的實際高度。 |
set | Drawing | 將巨集函式指派給這個繪圖。 |
set | Drawing | 設定繪圖在工作表中的顯示位置。 |
set | Drawing | 以像素為單位設定繪圖的實際寬度。 |
set | Drawing | 設定這個繪圖的 z-index。 |
內容詳盡的說明文件
get Container Info()
取得繪圖在工作表中的位置資訊。
回攻員
Container:包含繪圖容器位置的物件。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Height()
以像素為單位傳回這個繪圖的實際高度。
// 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()); }
回攻員
Integer:繪圖的高度 (以像素為單位)。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get On Action()
傳回附加至此繪圖的巨集名稱。
// 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()); }
回攻員
String|null:附加至此繪圖的巨集名稱。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Sheet()
傳回這個繪圖所在的試算表。
// 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()); }
回攻員
Sheet:繪圖所在的圖紙。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Width()
傳回這個繪圖的實際寬度 (以像素為單位)。
// 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()); }
回攻員
Integer:繪圖的寬度 (以像素為單位)。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get ZIndex()
傳回這個繪圖的 z-index。
// 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()); }
回攻員
Number:這個繪圖的 Z-Index。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
remove()
從試算表中刪除這項繪圖。對繪圖進行任何進一步操作都會導致指令碼錯誤。
// Deletes all drawings from the active sheet. const drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (let i = 0; i < drawings.length; i++) { drawings[i].remove(); }
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
set Height(height)
set On Action(macroName)
set Position(anchorRowPos, anchorColPos, offsetX, offsetY)
設定繪圖在工作表中的顯示位置。錨定列和欄位置索引是以 1 為起始。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
anchor | Integer | 繪圖的頂端會固定在這個資料列。 |
anchor | Integer | 繪圖的頂端會固定在這個資料欄中。 |
offsetX | Integer | 以像素為單位的儲存格角落水平偏移。 |
offsetY | Integer | 以像素為單位的儲存格角落垂直偏移。 |
回攻員
Drawing:用於鏈結的繪圖。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets