Class ImageItem

ImageItem

פריט פריסה שמוצגת בו תמונה. אפשר לגשת לפריטים או ליצור אותם מ-Form.

// Open a form by ID and add a new image item
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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);

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
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