Đại diện cho một bản vẽ trên một trang tính trong bảng tính.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
get | Container | Lấy thông tin về vị trí của bản vẽ trong trang tính. |
get | Integer | Trả về chiều cao thực tế của bản vẽ này tính bằng pixel. |
get | String|null | Trả về tên của macro được đính kèm vào bản vẽ này. |
get | Sheet | Trả về trang tính mà bản vẽ này xuất hiện. |
get | Integer | Trả về chiều rộng thực tế của bản vẽ này tính bằng pixel. |
get | Number | Trả về chỉ mục z của bản vẽ này. |
remove() | void | Xoá bản vẽ này khỏi bảng tính. |
set | Drawing | Đặt chiều cao thực tế của bản vẽ này tính bằng pixel. |
set | Drawing | Chỉ định một hàm macro cho bản vẽ này. |
set | Drawing | Đặt vị trí mà bản vẽ xuất hiện trên trang tính. |
set | Drawing | Đặt chiều rộng thực tế của bản vẽ này bằng pixel. |
set | Drawing | Đặt chỉ mục z của bản vẽ này. |
Tài liệu chi tiết
getContainerInfo()
Lấy thông tin về vị trí của bản vẽ trong trang tính.
Cầu thủ trả bóng
ContainerInfo – Một đối tượng chứa vị trí vùng chứa của bản vẽ.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getHeight()
Trả về chiều cao thực tế của bản vẽ này tính bằng pixel.
// 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()); }
Cầu thủ trả bóng
Integer – Chiều cao của bản vẽ tính bằng pixel.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getOnAction()
Trả về tên của macro được đính kèm vào bản vẽ này.
// 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()); }
Cầu thủ trả bóng
String|null – Tên macro được đính kèm vào bản vẽ này.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSheet()
Trả về trang tính mà bản vẽ này xuất hiện.
// 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()); }
Cầu thủ trả bóng
Sheet – Trang mà bản vẽ xuất hiện.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getWidth()
Trả về chiều rộng thực tế của bản vẽ này tính bằng pixel.
// 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()); }
Cầu thủ trả bóng
Integer – Chiều rộng của bản vẽ tính bằng pixel.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getZIndex()
Trả về chỉ mục z của bản vẽ này.
// 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()); }
Cầu thủ trả bóng
Number – Chỉ mục Z của bản vẽ này.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
remove()
Xoá bản vẽ này khỏi bảng tính. Mọi thao tác tiếp theo trên bản vẽ đều dẫn đến lỗi tập lệnh.
// Deletes all drawings from the active sheet. const drawings = SpreadsheetApp.getActiveSheet().getDrawings(); for (let i = 0; i < drawings.length; i++) { drawings[i].remove(); }
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
Đặt chiều cao thực tế của bản vẽ này tính bằng pixel.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
height | Integer | Chiều cao mong muốn tính bằng pixel. |
Cầu thủ trả bóng
Drawing – Bản vẽ này, để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setOnAction(macroName)
Chỉ định một hàm macro cho bản vẽ này.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
macro | String | Tên của hàm macro. |
Cầu thủ trả bóng
Drawing – Bản vẽ này, để xâu chuỗi.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
Đặt vị trí mà bản vẽ xuất hiện trên trang tính. Các chỉ mục vị trí hàng và cột của điểm neo được lập chỉ mục từ 1.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
anchor | Integer | Mặt trên của bản vẽ được neo vào hàng này. |
anchor | Integer | Mặt trên của bản vẽ được neo trong cột này. |
offsetX | Integer | Độ lệch ngang so với góc ô, tính bằng pixel. |
offsetY | Integer | Độ lệch dọc so với góc ô, tính bằng pixel. |
Cầu thủ trả bóng
Drawing – Bản vẽ này, để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
Đặt chiều rộng thực tế của bản vẽ này bằng pixel.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
width | Integer | Chiều rộng mong muốn tính bằng pixel. |
Cầu thủ trả bóng
Drawing – Bản vẽ này, để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setZIndex(zIndex)
Đặt chỉ mục z của bản vẽ này.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
zIndex | Number | Chỉ mục Z của bản vẽ này. |
Cầu thủ trả bóng
Drawing – Bản vẽ này, để xâu chuỗi.