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