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	הפונקציה מחזירה את הגיליון שבו מופיעה התמונה.
getUrl()	String	הפונקציה מקבלת את כתובת ה-URL של מקור התמונה. אם כתובת ה-URL לא זמינה, הפונקציה מחזירה את הערך null.
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	הגדרת רוחב התמונה בפועל בפיקסלים.

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

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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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

---

getUrl()

הפונקציה מקבלת את כתובת ה-URL של מקור התמונה. אם כתובת ה-URL לא זמינה, הפונקציה מחזירה את הערך null. אם התמונה הוכנסה באמצעות כתובת URL באמצעות API, השיטה הזו מחזירה את כתובת ה-URL שצוינה במהלך הוספת התמונה.

חזרה

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

אישור

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

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

---

getWidth()

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

// Logs the width of all images in a spreadsheet
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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
var images = SpreadsheetApp.getActiveSpreadsheet().getImages();
for (var 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