Class CellImage

CellImage

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

מאפיינים

נכססוגתיאור
valueTypeValueTypeסוג הערך של תמונת התא, שהוא ValueType.IMAGE.

Methods

שיטהסוג הערך שמוחזרתיאור קצר
getAltTextDescription()Stringהפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.
getAltTextTitle()Stringמחזירה את הכותרת של הטקסט החלופי של התמונה.
getContentUrl()Stringהפונקציה מחזירה כתובת URL של התמונה שמתארחת ב-Google.
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 שמוחזרת פג אחרי פרק זמן קצר.

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 שיוצר סוג ערך של תמונה על סמך מאפייני התמונה שצוינו.

שיטות שהוצאו משימוש