Class CellImageBuilder

CellImageBuilder

‫Builder של CellImage. הכלי הזה יוצר את ערך התמונה שנדרש כדי להוסיף תמונה לתא.

מאפיינים

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

Methods

שיטהסוג הערך שמוחזרתיאור קצר
build()CellImageיוצר את סוג הערך של התמונה שנדרש כדי להוסיף תמונה לתא.
getAltTextDescription()Stringהפונקציה מחזירה את תיאור הטקסט החלופי של התמונה הזו.
getAltTextTitle()Stringמחזירה את הכותרת של הטקסט החלופי של התמונה.
getContentUrl()Stringהפונקציה מחזירה כתובת URL של התמונה שמתארחת ב-Google.
setAltTextDescription(description)CellImageהגדרת תיאור הטקסט החלופי לתמונה הזו.
setAltTextTitle(title)CellImageההגדרה הזו קובעת את הכותרת של הטקסט החלופי לתמונה.
setSourceUrl(url)CellImageBuilderההגדרה הזו קובעת את כתובת ה-URL של מקור התמונה.
toBuilder()CellImageBuilderיוצרת כלי ליצירת תמונות בתאים על סמך מאפייני התמונה הנוכחיים.

תיעוד מפורט

build()

יוצר את סוג הערך של התמונה שנדרש כדי להוסיף תמונה לתא. ערך התמונה מורכב ממאפייני התמונה שנוספו לכלי הפיתוח, כמו כתובת ה-URL של המקור.

חזרה

‫CellImage — ייצוג של התמונה שרוצים להוסיף לתא.

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.

setAltTextDescription(description)

הגדרת תיאור הטקסט החלופי לתמונה הזו.

פרמטרים

שםסוגתיאור
descriptionStringהתיאור החדש של הטקסט החלופי לתמונה.

חזרה

‫CellImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setAltTextTitle(title)

ההגדרה הזו קובעת את הכותרת של הטקסט החלופי לתמונה.

פרמטרים

שםסוגתיאור
titleStringהכותרת החדשה של הטקסט החלופי לתמונה.

חזרה

‫CellImage — התמונה הזו, לשרשור.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSourceUrl(url)

ההגדרה הזו קובעת את כתובת ה-URL של מקור התמונה.

פרמטרים

שםסוגתיאור
urlStringכתובת ה-URL של התמונה.

חזרה

‫CellImageBuilder – ה-builder הזה, לשרשור.

toBuilder()

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

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