מייצגת ערך של תמונה בתא. כדי להוסיף תמונה לתא, צריך ליצור ערך תמונה חדש לתמונה באמצעות SpreadsheetApp.newCellImage() ו-CellImageBuilder. אחר כך אפשר להשתמש ב-Range.setValue(value) או ב-Range.setValues(values) כדי להוסיף את ערך התמונה לתא.
מאפיינים
| נכס | סוג | תיאור |
|---|---|---|
value | Value | סוג הערך של תמונת התא, שהוא Value. |
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
get | String | הפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו. |
get | String | מחזירה את הכותרת של הטקסט החלופי של התמונה. |
get | String | הפונקציה מחזירה כתובת URL של התמונה שמתארחת ב-Google. |
to | Cell | יוצרת כלי ליצירת תמונות בתאים על סמך מאפייני התמונה הנוכחיים. |
תיעוד מפורט
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 שמוחזרת פג אחרי פרק זמן קצר.
const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { console.log(value.getContentUrl()); }
חזרה
String – כתובת ה-URL של התמונה שמתארחת ב-Google.
toBuilder()
יוצרת כלי ליצירת תמונות בתאים על סמך מאפייני התמונה הנוכחיים. משתמשים ב-CellImageBuilder.setSourceUrl(url) כדי להגדיר את כתובת ה-URL של התמונה החדשה. אחר כך אפשר להוסיף אותו לתא באמצעות Range.setValue(value) או Range.setValues(values).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const range = ss.getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { const newImage = value.toBuilder() .setSourceUrl( 'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png', ) .build(); const newRange = ss.getRange("Sheet1!A2"); newRange.setValue(newImage); }
חזרה
CellImageBuilder – builder שיוצר סוג ערך של תמונה על סמך מאפייני התמונה שצוינו.