Class CellImage

תאתמונה

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

מאפיינים

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

Methods

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

מסמכים מפורטים

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()

יצירת ה-builder של קובץ האימג' של התא על סמך מאפייני האימג' הנוכחיים. משתמשים ב-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 – בונה שיוצר סוג של ערך תמונה על סמך מאפייני התמונה הנתונים.

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