בנאי של CellImage
. הכלי הזה יוצר את ערך התמונה שנדרש כדי להוסיף תמונה לתא.
תכונות
נכס | תיאור | התיאור |
---|---|---|
valueType | ValueType | שדה שמוגדר בתור ValueType.IMAGE , ומייצג את סוג הערך של התמונה. |
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
build() | CellImage | יוצרת את סוג הערך של התמונה הדרוש להוספת תמונה לתא. |
getAltTextDescription() | String | הפונקציה מחזירה את תיאור הטקסט החלופי לתמונה הזו. |
getAltTextTitle() | String | מחזירה את כותרת הטקסט החלופי לתמונה זו. |
getContentUrl() | String | מחזירה לתמונה כתובת URL שמתארחת ב-Google. |
getUrl() | String | הפונקציה מחזירה את כתובת ה-URL של התמונה המקורית, ומחזירה את הערך null אם כתובת ה-URL לא זמינה. |
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 שהוחזרה פג לאחר פרק זמן קצר.
החזרות
String
- כתובת ה-URL של התמונה באירוח Google.
getUrl()
הפונקציה מחזירה את כתובת ה-URL של התמונה המקורית, ומחזירה את הערך null
אם כתובת ה-URL לא זמינה. אם התמונה נוספה על ידי כתובת URL באמצעות API, השיטה הזו מחזירה את כתובת ה-URL שצוינה במהלך הוספת התמונה.
החזרות
String
– כתובת ה-URL של התמונה, אם היא זמינה. הפונקציה מחזירה את הערך null
אם התמונה לא זמינה או שאין לה
כתובת URL של מקור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
מגדיר את תיאור הטקסט החלופי לתמונה הזו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
description | String | התיאור החדש של הטקסט החלופי לתמונה. |
החזרות
CellImage
- התמונה הזו, לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
מגדיר את כותרת הטקסט החלופי לתמונה הזו.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת החדשה של הטקסט החלופי לתמונה. |
החזרות
CellImage
- התמונה הזו, לשרשור.
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSourceUrl(url)
מגדיר את כתובת ה-URL של מקור התמונה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
url | String | כתובת ה-URL של התמונה. |
החזרות
CellImageBuilder
– הכלי הזה – לשרשורים.
toBuilder()
הוא יוצר כלי שהופך תמונה לסוג ערך של תמונה, כדי שתוכלו להציב אותה בתא. כדי להוסיף תמונה לתא, צריך ליצור אותה בתור סוג של ערך תמונה.
לאחר מכן אפשר להוסיף אותו לתא באמצעות הפונקציה Range.setValue(value)
או Range.setValues(values)
.
החזרות
CellImageBuilder
– כלי ליצירת סוג של ערך לתמונה על סמך מאפיינים נתונים של תמונה.