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

Class 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