Class CellImageBuilder

CellImageBuilder

ה-builder של CellImage. ה-builder הזה יוצר את ערך התמונה הנדרש להוספת תמונה לתא.

מאפיינים

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

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

build()

יצירת סוג הערך של התמונה שנדרש כדי להוסיף תמונה לתא. ערך התמונה נוצר ממאפייני התמונה שנוספו ל-builder, כמו כתובת ה-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()

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

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