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

תיעוד מפורט

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

פרמטרים

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

החזרות

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