פריט פריסה שמציג תמונה. ניתן לגשת לפריטים או ליצור אותם מ-Form
.
// Open a form by ID and add a new image item var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var img = UrlFetchApp.fetch('https://www.google.com/images/srpr/logo4w.png'); form.addImageItem() .setTitle('Google') .setHelpText('Google Logo') // The help text is the image description .setImage(img);
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
duplicate() | ImageItem | יוצר עותק של הפריט הזה ומצרף אותו לסוף הטופס. |
getAlignment() | Alignment | קבלת היישור האופקי של התמונה. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (שנקרא לפעמים 'טקסט תיאור' של פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getImage() | Blob | קבלת התמונה שמוקצית כרגע לפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט בין כל הפריטים בטופס. |
getTitle() | String | הפונקציה מקבלת את שם הפריט (לפעמים נקרא 'טקסט כותרת' במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצגת באמצעות ItemType . |
getWidth() | Integer | מקבל את רוחב התמונה בפיקסלים. |
setAlignment(alignment) | ImageItem | מגדיר את היישור האופקי של התמונה. |
setHelpText(text) | ImageItem | מגדיר את טקסט העזרה של הפריט (לפעמים נקרא 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setImage(image) | ImageItem | מגדיר את התמונה עצמה. |
setTitle(title) | ImageItem | מגדיר את כותרת הפריט (לפעמים נקרא 'טקסט כותרת', במקרה של SectionHeaderItem ). |
setWidth(width) | ImageItem | מגדיר את רוחב התמונה בפיקסלים. |
מסמכי תיעוד מפורטים
duplicate()
יוצר עותק של הפריט הזה ומצרף אותו לסוף הטופס.
חזרה
ImageItem
– כפילות של ImageItem
, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getAlignment()
קבלת היישור האופקי של התמונה.
חזרה
Alignment
– היישור האופקי
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' של פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
חזרה
String
– טקסט העזרה או טקסט התיאור של הפריט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
הפונקציה מקבלת את המזהה הייחודי של הפריט.
חזרה
Integer
– מזהה הפריט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getImage()
קבלת התמונה שמוקצית כרגע לפריט.
חזרה
Blob
– נתוני התמונה
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
הפונקציה מקבלת את האינדקס של הפריט בין כל הפריטים בטופס.
חזרה
Integer
– האינדקס של הפריט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
הפונקציה מקבלת את שם הפריט (לפעמים נקרא 'טקסט כותרת' במקרה של SectionHeaderItem
).
חזרה
String
– טקסט הכותרת או הכותרת של הפריט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
הפונקציה מקבלת את סוג הפריט, שמיוצגת באמצעות ItemType
.
חזרה
ItemType
– סוג הפריט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getWidth()
מקבל את רוחב התמונה בפיקסלים.
חזרה
Integer
– הרוחב בפיקסלים
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAlignment(alignment)
מגדיר את היישור האופקי של התמונה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
alignment | Alignment | היישור האופקי |
חזרה
ImageItem
– הImageItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (לפעמים נקרא 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | טקסט העזרה החדש |
חזרה
ImageItem
– הImageItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setImage(image)
מגדיר את התמונה עצמה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
image | BlobSource | נתוני התמונה |
חזרה
ImageItem
– הImageItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (לפעמים נקרא 'טקסט כותרת', במקרה של SectionHeaderItem
).
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | הטקסט של הכותרת או הכותרת החדשים |
חזרה
ImageItem
– הImageItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setWidth(width)
מגדיר את רוחב התמונה בפיקסלים. אפשר להגדיר רק את רוחב התמונה. הגובה הוגדר כדי לשמור על הפרופורציות של התמונה באופן אוטומטי.
פרמטרים
שם | סוג | תיאור |
---|---|---|
width | Integer | הרוחב בפיקסלים |
חזרה
ImageItem
– הImageItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms