מייצג ערך תמונה בתא. כדי להוסיף תמונה לתא, צריך ליצור ערך תמונה חדש של התמונה באמצעות Spreadsheet
ו-Cell
. לאחר מכן תוכלו להשתמש ב-Range.setValue(value)
או ב-Range.setValues(values)
כדי להוסיף את ערך התמונה לתא.
מאפיינים
נכס | סוג | תיאור |
---|---|---|
value | Value | סוג הערך של תמונת התא, שהוא Value . |
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
get | String | הפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו. |
get | String | הפונקציה מחזירה את כותרת הטקסט החלופי של התמונה הזו. |
get | String | הפונקציה מחזירה כתובת URL של התמונה שמתארחת ב-Google. |
to | Cell | יצירת ה-builder של קובץ האימג' של התא על סמך מאפייני התמונה הנוכחיים. |
מסמכים מפורטים
get Alt Text Description()
הפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.
חזרה
String
— תיאור הטקסט החלופי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Alt Text Title()
הפונקציה מחזירה את כותרת הטקסט החלופי של התמונה הזו.
חזרה
String
— הכותרת של הטקסט החלופי.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Content Url()
הפונקציה מחזירה כתובת 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.
to Builder()
יצירת ה-builder של קובץ האימג' של התא על סמך מאפייני האימג' הנוכחיים. משתמשים ב-Cell
כדי להגדיר את כתובת ה-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); }
חזרה
Cell
– בונה שיוצר סוג של ערך תמונה על סמך מאפייני התמונה הנתונים.