Class Drawing

שרטוט

מייצג שרטוט מעל גיליון בגיליון אלקטרוני.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
getContainerInfo()	ContainerInfo	מקבל מידע על מיקום השרטוט בגיליון.
getHeight()	Integer	מחזירה את הגובה בפועל של שרטוט זה בפיקסלים.
getOnAction()	String	מחזירה את השם של המאקרו שמצורף לשרטוט.
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 - אובייקט שמכיל את מיקום הקונטיינר של השרטוט.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

---

getHeight()

מחזירה את הגובה בפועל של שרטוט זה בפיקסלים.

// Logs the height of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

---

getOnAction()

מחזירה את השם של המאקרו שמצורף לשרטוט.

// Logs the macro name of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

חזרה

String — השם של המאקרו שמצורף לשרטוט הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• 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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

---

getWidth()

מחזירה את הרוחב בפועל של שרטוט זה בפיקסלים.

// Logs the width of all drawings in a sheet
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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

---

getZIndex()

מחזירה את מדד ה-z של שרטוט זה.

// Logs the z-index of all drawings on the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

חזרה

Number – אינדקס Z בשרטוט הזה.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

---

remove()

מחיקת השרטוט הזה מהגיליון האלקטרוני. כל פעולה נוספת על הציור תגרור שגיאת סקריפט.

// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

---

setHeight(height)

מגדיר את הגובה בפועל של שרטוט זה בפיקסלים.

פרמטרים

שם	סוג	תיאור
height	Integer	הגובה הרצוי בפיקסלים.

חזרה

Drawing – השרטוט הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

• 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 – השרטוט הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

---

setWidth(width)

מגדיר את הרוחב בפועל של שרטוט זה בפיקסלים.

פרמטרים

שם	סוג	תיאור
width	Integer	הרוחב הרצוי בפיקסלים.

חזרה

Drawing – השרטוט הזה, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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

---

setZIndex(zIndex)

מגדיר את מדד ה-z של השרטוט הזה.

פרמטרים

שם	סוג	תיאור
zIndex	Number	אינדקס Z של השרטוט הזה.

חזרה

Drawing – השרטוט הזה, לשרשור.