Class Drawing

วาดเขียน

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

เมธอด

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

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

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

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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-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 ของภาพวาดนี้

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setOnAction(macroName)

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

พารามิเตอร์

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

รีเทิร์น

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

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
anchorRowPos	Integer	ด้านบนของรูปภาพจะยึดอยู่ในแถวนี้
anchorColPos	Integer	ด้านบนของรูปภาพจะยึดในคอลัมน์นี้
offsetX	Integer	การเลื่อนแนวนอนจากมุมเซลล์เป็นพิกเซล
offsetY	Integer	การเลื่อนแนวตั้งจากมุมเซลล์เป็นพิกเซล

รีเทิร์น

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

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

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

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

---

setWidth(width)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setZIndex(zIndex)

ตั้งค่า z-index ของภาพวาดนี้

พารามิเตอร์

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

รีเทิร์น

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