Class OverGridImage

OverGridImage

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

שיטות

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