Class Drawing

วาดเขียน

แสดงภาพวาดบนชีตในสเปรดชีต

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getContainerInfo()ContainerInfoรับข้อมูลเกี่ยวกับตำแหน่งของภาพวาดในชีต
getHeight()Integerแสดงผลความสูงจริงของการวาดนี้ในหน่วยพิกเซล
getOnAction()String|nullแสดงผลชื่อของมาโครที่แนบมากับภาพวาดนี้
getSheet()Sheetแสดงชีตที่ภาพวาดนี้ปรากฏ
getWidth()Integerแสดงผลความกว้างจริงของภาพวาดนี้ในหน่วยพิกเซล
getZIndex()Numberแสดงดัชนี z ของภาพวาดนี้
remove()voidลบภาพวาดนี้ออกจากสเปรดชีต
setHeight(height)Drawingตั้งค่าความสูงจริงของภาพวาดนี้เป็นพิกเซล
setOnAction(macroName)Drawingกำหนดฟังก์ชันมาโครให้กับภาพวาดนี้
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)Drawingกำหนดตำแหน่งที่ภาพวาดจะปรากฏในชีต
setWidth(width)Drawingกำหนดความกว้างจริงของการวาดนี้เป็นพิกเซล
setZIndex(zIndex)Drawingตั้งค่าดัชนีลำดับ Z ของภาพวาดนี้

เอกสารโดยละเอียด

getContainerInfo()

รับข้อมูลเกี่ยวกับตำแหน่งของภาพวาดในชีต

รีเทิร์น

ContainerInfo — ออบเจ็กต์ที่มีตำแหน่งคอนเทนเนอร์ของภาพวาด

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getHeight()

แสดงผลความสูงจริงของการวาดนี้ในหน่วยพิกเซล 

// 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 — ความสูงของภาพวาดเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getOnAction()

แสดงผลชื่อของมาโครที่แนบมากับภาพวาดนี้ 

// 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 - ชื่อมาโครที่แนบมากับภาพวาดนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSheet()

แสดงชีตที่ภาพวาดนี้ปรากฏ 

// 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 — ชีตที่ภาพวาดปรากฏ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getWidth()

แสดงผลความกว้างจริงของภาพวาดนี้ในหน่วยพิกเซล 

// 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 — ความกว้างของภาพวาดเป็นพิกเซล

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getZIndex()

แสดงดัชนี z ของภาพวาดนี้ 

// 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 ของภาพวาดนี้

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • 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();
}

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeight(height)

ตั้งค่าความสูงจริงของภาพวาดนี้เป็นพิกเซล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
heightIntegerความสูงที่ต้องการเป็นพิกเซล

รีเทิร์น

Drawing — ภาพวาดนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setOnAction(macroName)

กำหนดฟังก์ชันมาโครให้กับภาพวาดนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
macroNameStringชื่อฟังก์ชันมาโคร

รีเทิร์น

Drawing — ภาพวาดนี้สำหรับการเชื่อมโยง

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

กำหนดตำแหน่งที่ภาพวาดจะปรากฏในชีต ดัชนีตำแหน่งแถวและคอลัมน์ของจุดยึด จะเริ่มที่ 1

พารามิเตอร์

ชื่อประเภทคำอธิบาย
anchorRowPosIntegerด้านบนของภาพวาดจะยึดไว้ในแถวนี้
anchorColPosIntegerด้านบนของภาพวาดจะยึดไว้ในคอลัมน์นี้
offsetXIntegerออฟเซ็ตแนวนอนจากมุมเซลล์เป็นพิกเซล
offsetYIntegerออฟเซ็ตแนวตั้งจากมุมของเซลล์ในหน่วยพิกเซล

รีเทิร์น

Drawing — ภาพวาดนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWidth(width)

กำหนดความกว้างจริงของการวาดนี้เป็นพิกเซล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
widthIntegerความกว้างที่ต้องการเป็นพิกเซล

รีเทิร์น

Drawing — ภาพวาดนี้สำหรับการเชื่อมโยง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setZIndex(zIndex)

ตั้งค่าดัชนีลำดับ Z ของภาพวาดนี้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
zIndexNumberดัชนีลำดับ Z ของภาพวาดนี้

รีเทิร์น

Drawing — ภาพวาดนี้สำหรับการเชื่อมโยง