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

Class CellImage

מייצגת תמונה להוספה לתא. כדי להוסיף תמונה לתא, צריך ליצור ערך תמונה חדש לתמונה באמצעות SpreadsheetApp.newCellImage() ו-CellImageBuilder. לאחר מכן אפשר להשתמש ב-Range.setValue(value) או ב-Range.setValues(values) כדי להוסיף את ערך התמונה לתא.

תכונות

נכס	תיאור	התיאור
`valueType`	`ValueType`	שדה שמוגדר בתור `ValueType.IMAGE`, ומייצג את סוג הערך של התמונה.

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`getAltTextDescription()`	`String`	הפונקציה מחזירה את תיאור הטקסט החלופי לתמונה הזו.
`getAltTextTitle()`	`String`	מחזירה את כותרת הטקסט החלופי לתמונה זו.
`getContentUrl()`	`String`	מחזירה לתמונה כתובת URL שמתארחת ב-Google.
`getUrl()`	`String`	הפונקציה מחזירה את כתובת ה-URL של התמונה המקורית, ומחזירה את הערך `null` אם כתובת ה-URL לא זמינה.
`toBuilder()`	`CellImageBuilder`	הוא יוצר כלי שהופך תמונה לסוג ערך של תמונה, כדי שתוכלו להציב אותה בתא.

תיעוד מפורט

`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

`getContentUrl()`

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

החזרות

String - כתובת ה-URL של התמונה באירוח Google.

`getUrl()`

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

החזרות

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

הרשאות

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

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

`toBuilder()`

הוא יוצר כלי שהופך תמונה לסוג ערך של תמונה, כדי שתוכלו להציב אותה בתא. כדי להוסיף תמונה לתא, צריך ליצור אותה בתור סוג של ערך תמונה. לאחר מכן אפשר להוסיף אותו לתא באמצעות הפונקציה Range.setValue(value) או Range.setValues(values).

החזרות

CellImageBuilder – כלי ליצירת סוג של ערך לתמונה על סמך מאפיינים נתונים של תמונה.