ייצוג של ציור מעל גיליון בגיליון אלקטרוני.
Methods
| שיטה | סוג הערך המוחזר | תיאור קצר | 
|---|---|---|
| get | Container | הפונקציה מקבלת מידע על המיקום של הציור בגיליון. | 
| get | Integer | הפונקציה מחזירה את הגובה בפועל של הציור הזה בפיקסלים. | 
| get | String | הפונקציה מחזירה את השם של המאקרו שמצורף לתרשים הזה. | 
| get | Sheet | הפונקציה מחזירה את הגיליון שבו מופיע הציור. | 
| get | Integer | הפונקציה מחזירה את הרוחב בפועל של הציור הזה בפיקסלים. | 
| get | Number | הפונקציה מחזירה את אינדקס z של הציור הזה. | 
| remove() | void | מחיקת הציור מהגיליון האלקטרוני. | 
| set | Drawing | הגדרת הגובה בפועל של הציור הזה בפיקסלים. | 
| set | Drawing | הקצאת פונקציית מאקרו לתרשים הזה. | 
| set | Drawing | מגדיר את המיקום שבו הציור יופיע בגיליון. | 
| set | Drawing | הגדרת הרוחב בפועל של הציור הזה בפיקסלים. | 
| set | Drawing | הגדרת ה-z-index של השרטוט הזה. | 
מסמכים מפורטים
get
הפונקציה מקבלת מידע על המיקום של הציור בגיליון.
חזרה
Container – אובייקט שמכיל את המיקום של הקונטיינר של הציור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
get
הפונקציה מחזירה את הגובה בפועל של הציור הזה בפיקסלים.
// 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 – הגובה של הציור בפיקסלים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
get
הפונקציה מחזירה את השם של המאקרו שמצורף לתרשים הזה.
// 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 – שם המאקרו שמשויך לשרטוט הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
get
הפונקציה מחזירה את הגיליון שבו מופיע הציור.
// 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 – הגיליון שבו מופיע הציור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
get
הפונקציה מחזירה את הרוחב בפועל של הציור הזה בפיקסלים.
// 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 – רוחב הציור בפיקסלים.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
get
הפונקציה מחזירה את אינדקס 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 של השרטוט הזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
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(); }
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
set
הגדרת הגובה בפועל של הציור הזה בפיקסלים.
פרמטרים
| שם | סוג | תיאור | 
|---|---|---|
| height | Integer | הגובה הרצוי בפיקסלים. | 
חזרה
Drawing — השרטוט הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
set
הקצאת פונקציית מאקרו לתרשים הזה.
פרמטרים
| שם | סוג | תיאור | 
|---|---|---|
| macro | String | השם של פונקציית המאקרו. | 
חזרה
Drawing — השרטוט הזה, לצורך קישור.
set
מגדיר את המיקום שבו הציור יופיע בגיליון. האינדקסים של מיקומי השורה והעמודה של עוגן מתחילים ב-1.
פרמטרים
| שם | סוג | תיאור | 
|---|---|---|
| anchor | Integer | החלק העליון של הציור מעוגן בשורה הזו. | 
| anchor | Integer | הצד העליון של הציור מקובע בעמודה הזו. | 
| offsetX | Integer | הסטייה האופקית מפינה התא בפיקסלים. | 
| offsetY | Integer | הסטייה האנכית מפינה התא, בפיקסלים. | 
חזרה
Drawing — השרטוט הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
set
הגדרת הרוחב בפועל של הציור הזה בפיקסלים.
פרמטרים
| שם | סוג | תיאור | 
|---|---|---|
| width | Integer | הרוחב הרצוי בפיקסלים. | 
חזרה
Drawing — השרטוט הזה, לצורך קישור.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
set
הגדרת ה-z-index של השרטוט הזה.
פרמטרים
| שם | סוג | תיאור | 
|---|---|---|
| zIndex | Number | אינדקס Z של השרטוט הזה. | 
חזרה
Drawing — השרטוט הזה, לצורך קישור.