מייצג שרטוט של גיליון בגיליון אלקטרוני.
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
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
– השרטוט הזה, לשרשור.