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