Class CellImage

תאתמונה

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

מאפיינים

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

Methods

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

חזרה

String – כתובת ה-URL של התמונה שמתארחת ב-Google.

getUrl()

הפונקציה מקבלת את כתובת ה-URL של מקור התמונה. אם כתובת ה-URL לא זמינה, הפונקציה מחזירה את הערך null. אם התמונה הוכנסה באמצעות כתובת URL באמצעות API, השיטה הזו מחזירה את כתובת ה-URL שצוינה במהלך הוספת התמונה.

חזרה

String – כתובת ה-URL של התמונה, אם היא זמינה. הפונקציה מחזירה את הערך null אם התמונה לא זמינה או שאין לה כתובת URL של מקור.

אישור

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

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

toBuilder()

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

חזרה

CellImageBuilder – בונה שיוצר סוג של ערך תמונה על סמך מאפייני התמונה הנתונים.