Class Drawing

Vẽ

Đạ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ứcKiểu dữ liệu trả vềMô tả ngắn
getContainerInfo()ContainerInfoLấy thông tin về vị trí của bản vẽ trong trang tính.
getHeight()IntegerTrả về chiều cao thực tế của bản vẽ này tính bằng pixel.
getOnAction()String|nullTrả về tên của macro được đính kèm vào bản vẽ này.
getSheet()SheetTrả về trang tính mà bản vẽ này xuất hiện.
getWidth()IntegerTrả về chiều rộng thực tế của bản vẽ này tính bằng pixel.
getZIndex()NumberTrả về chỉ mục z của bản vẽ này.
remove()voidXoá bản vẽ này khỏi bảng tính.
setHeight(height)DrawingĐặt chiều cao thực tế của bản vẽ này tính bằng pixel.
setOnAction(macroName)DrawingChỉ định một hàm macro cho bản vẽ này.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)DrawingĐặt vị trí mà bản vẽ xuất hiện trên trang tính.
setWidth(width)DrawingĐặt chiều rộng thực tế của bản vẽ này bằng pixel.
setZIndex(zIndex)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.

Thông số

TênLoạiMô tả
heightIntegerChiề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.

Thông số

TênLoạiMô tả
macroNameStringTê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. Chỉ mục vị trí hàng và cột của ô neo được lập chỉ mục từ 1.

Thông số

TênLoạiMô tả
anchorRowPosIntegerMặt trên của bản vẽ được neo vào hàng này.
anchorColPosIntegerMặt trên của bản vẽ được neo trong cột này.
offsetXIntegerĐộ lệch ngang so với góc ô, tính bằng pixel.
offsetYIntegerĐộ 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.

Thông số

TênLoạiMô tả
widthIntegerChiề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.

Thông số

TênLoạiMô tả
zIndexNumberChỉ 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.