דף זה תורגם על ידי Cloud Translation API.

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