Class ImageItem

ImageItem

פריט פריסה שמציג תמונה. ניתן לגשת לפריטים או ליצור אותם מ-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)

מגדיר את היישור האופקי של התמונה.

פרמטרים

שםסוגתיאור
alignmentAlignmentהיישור האופקי

חזרה

ImageItem – הImageItem הזה, לשרשור

אישור

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

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

setHelpText(text)

מגדיר את טקסט העזרה של הפריט (לפעמים נקרא 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).

פרמטרים

שםסוגתיאור
textStringטקסט העזרה החדש

חזרה

ImageItem – הImageItem הזה, לשרשור

אישור

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

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

setImage(image)

מגדיר את התמונה עצמה.

פרמטרים

שםסוגתיאור
imageBlobSourceנתוני התמונה

חזרה

ImageItem – הImageItem הזה, לשרשור

אישור

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

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

setTitle(title)

מגדיר את כותרת הפריט (לפעמים נקרא 'טקסט כותרת', במקרה של SectionHeaderItem).

פרמטרים

שםסוגתיאור
titleStringהטקסט של הכותרת או הכותרת החדשים

חזרה

ImageItem – הImageItem הזה, לשרשור

אישור

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

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

setWidth(width)

מגדיר את רוחב התמונה בפיקסלים. אפשר להגדיר רק את רוחב התמונה. הגובה הוגדר כדי לשמור על הפרופורציות של התמונה באופן אוטומטי.

פרמטרים

שםסוגתיאור
widthIntegerהרוחב בפיקסלים

חזרה

ImageItem – הImageItem הזה, לשרשור

אישור

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

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