Class OverGridImage

OverGridImage

מייצגת תמונה מעל לרשת התאים בגיליון אלקטרוני.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
assignScript(functionName)	OverGridImage	הקצאת הפונקציה עם שם הפונקציה שצוין לאימג' הזה.
getAltTextDescription()	String	הפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.
getAltTextTitle()	String	הפונקציה מחזירה את כותרת הטקסט החלופי של התמונה הזו.
getAnchorCell()	Range	הפונקציה מחזירה את התא שאליו תמונה מקובעת.
getAnchorCellXOffset()	Integer	הפונקציה מחזירה את ההיסט האופקית בפיקסלים מתא העוגן.
getAnchorCellYOffset()	Integer	הפונקציה מחזירה את ההיסט האנכי בפיקסלים מתא העוגן.
getHeight()	Integer	הפונקציה מחזירה את הגובה בפועל של התמונה הזו בפיקסלים.
getInherentHeight()	Integer	הפונקציה מחזירה את הגובה המובנה של התמונה הזו בפיקסלים.
getInherentWidth()	Integer	הפונקציה מחזירה את הגובה המובנה של התמונה הזו בפיקסלים.
getScript()	String	הפונקציה מחזירה את השם של הפונקציה שהוקצתה לאימג' הזה.
getSheet()	Sheet	הפונקציה מחזירה את הגיליון שבו מופיעה התמונה.
getWidth()	Integer	הפונקציה מחזירה את הרוחב בפועל של התמונה הזו בפיקסלים.
remove()	void	מחיקת התמונה הזו מהגיליון האלקטרוני.
replace(blob)	OverGridImage	החלפת התמונה הזו בתמונה שצוינה ב-BlobSource שסופק.
replace(url)	OverGridImage	התמונה הזו מוחלפת בתמונה מכתובת ה-URL שצוינה.
resetSize()	OverGridImage	איפוס התמונה למימדים המקוריים שלה.
setAltTextDescription(description)	OverGridImage	הגדרת התיאור של הטקסט החלופי לתמונה הזו.
setAltTextTitle(title)	OverGridImage	הגדרת הכותרת של הטקסט החלופי לתמונה הזו.
setAnchorCell(cell)	OverGridImage	הגדרת התא שאליו תמונה מקובעת.
setAnchorCellXOffset(offset)	OverGridImage	הגדרת ההיסט האופקית בפיקסלים מהתא העוגן.
setAnchorCellYOffset(offset)	OverGridImage	הגדרת ההיסט האנכי בפיקסלים מתא העוגן.
setHeight(height)	OverGridImage	הגדרת הגובה בפועל של התמונה הזו בפיקסלים.
setWidth(width)	OverGridImage	הגדרת רוחב התמונה בפועל בפיקסלים.

שיטות שהוצאו משימוש

שיטה	סוג הערך המוחזר	תיאור קצר
getUrl()	String	הפונקציה מקבלת את כתובת ה-URL של מקור התמונה.

מסמכים מפורטים

assignScript(functionName)

הקצאת הפונקציה עם שם הפונקציה שצוין לאימג' הזה.

פרמטרים

שם	סוג	תיאור
functionName	String	שם הפונקציה שצוינה. זו חייבת להיות פונקציה ציבורית ברמה עליונה, ולא פונקציה שמסתיימת בקו תחתון, כמו privateFunction_.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAltTextDescription()

הפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.

חזרה

String – תיאור הטקסט החלופי.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAltTextTitle()

הפונקציה מחזירה את כותרת הטקסט החלופי של התמונה הזו.

חזרה

String — כותרת הטקסט החלופי.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAnchorCell()

הפונקציה מחזירה את התא שאליו תמונה מקובעת.

חזרה

Range – תא העוגן.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAnchorCellXOffset()

הפונקציה מחזירה את ההיסט האופקית בפיקסלים מתא העוגן.

חזרה

Integer – ההיסט האופקי בפיקסלים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getAnchorCellYOffset()

הפונקציה מחזירה את ההיסט האנכי בפיקסלים מתא העוגן.

חזרה

Integer – ההיסט האנכי בפיקסלים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getHeight()

הפונקציה מחזירה את הגובה בפועל של התמונה הזו בפיקסלים.

// Logs the height of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getHeight());
}

חזרה

Integer – הגובה של התמונה בפיקסלים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getInherentHeight()

הפונקציה מחזירה את הגובה המובנה של התמונה הזו בפיקסלים.

חזרה

Integer – הגובה המובנה בפיקסלים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getInherentWidth()

הפונקציה מחזירה את הגובה המובנה של התמונה הזו בפיקסלים.

חזרה

Integer – הרוחב המובנה בפיקסלים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getScript()

הפונקציה מחזירה את השם של הפונקציה שהוקצתה לאימג' הזה.

חזרה

String – שם הפונקציה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getSheet()

הפונקציה מחזירה את הגיליון שבו מופיעה התמונה.

// Logs the parent sheet of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getSheet());
}

חזרה

Sheet – הגיליון שבו מופיעה התמונה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getWidth()

הפונקציה מחזירה את הרוחב בפועל של התמונה הזו בפיקסלים.

// Logs the width of all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  Logger.log(images[i].getWidth());
}

חזרה

Integer – רוחב התמונה בפיקסלים.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

remove()

מחיקת התמונה הזו מהגיליון האלקטרוני. כל פעולה נוספת על התמונה תגרום לשגיאת סקריפט.

// Deletes all images in a spreadsheet
const images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (let i = 0; i < images.length; i++) {
  images[i].remove();
}

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

replace(blob)

החלפת התמונה הזו בתמונה שצוינה ב-BlobSource שסופק. גודל ה-blob המקסימלי שנתמך הוא 2MB.

פרמטרים

שם	סוג	תיאור
blob	BlobSource	התמונה החדשה כ-Blob.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

replace(url)

התמונה הזו מוחלפת בתמונה מכתובת ה-URL שצוינה.

פרמטרים

שם	סוג	תיאור
url	String	כתובת ה-URL של התמונה החדשה.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

resetSize()

איפוס התמונה למימדים המקוריים שלה.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setAltTextDescription(description)

הגדרת התיאור של הטקסט החלופי לתמונה הזו.

פרמטרים

שם	סוג	תיאור
description	String	תיאור הטקסט החלופי החדש של התמונה.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setAltTextTitle(title)

הגדרת הכותרת של הטקסט החלופי לתמונה הזו.

פרמטרים

שם	סוג	תיאור
title	String	כותרת הטקסט החלופי החדש של התמונה.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setAnchorCell(cell)

הגדרת התא שאליו תמונה מקובעת.

פרמטרים

שם	סוג	תיאור
cell	Range	תא העוגן החדש.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setAnchorCellXOffset(offset)

הגדרת ההיסט האופקית בפיקסלים מהתא העוגן.

פרמטרים

שם	סוג	תיאור
offset	Integer	ההיסט האופקי החדש בפיקסלים.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setAnchorCellYOffset(offset)

הגדרת ההיסט האנכי בפיקסלים מתא העוגן.

פרמטרים

שם	סוג	תיאור
offset	Integer	ההיסט החדש של הפיקסלים האנכיים.

חזרה

OverGridImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setHeight(height)

הגדרת הגובה בפועל של התמונה הזו בפיקסלים.

פרמטרים

שם	סוג	תיאור
height	Integer	הגובה הרצוי בפיקסלים.

חזרה

OverGridImage – התמונה לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setWidth(width)

הגדרת רוחב התמונה בפועל בפיקסלים.

פרמטרים

שם	סוג	תיאור
width	Integer	הרוחב הרצוי בפיקסלים.

חזרה

OverGridImage – התמונה לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

שיטות שהוצאו משימוש

getUrl()

הוצא משימוש. ברוב התמונות שנוספו לאחרונה, כתובת ה-URL המקורית לא זמינה.

הפונקציה מקבלת את כתובת ה-URL של מקור התמונה. הפונקציה מחזירה מחרוזת ריקה אם כתובת ה-URL לא זמינה. ברוב התמונות החדשות שמוסיפים, כתובת ה-URL המקורית לא זמינה, ללא קשר לאופן שבו התמונה נוספה.

חזרה

String – כתובת ה-URL של מקור התמונה, אם היא זמינה. אחרת, הפונקציה מחזירה מחרוזת ריקה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets