Class 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היישור האופקי

הלוך ושוב

ImageItemImageItem זה, לשרשור

הרשאה

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

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

setHelpText(text)

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

פרמטרים

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

הלוך ושוב

ImageItemImageItem זה, לשרשור

הרשאה

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

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

setImage(image)

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

פרמטרים

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

הלוך ושוב

ImageItemImageItem זה, לשרשור

הרשאה

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

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

setTitle(title)

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

פרמטרים

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

הלוך ושוב

ImageItemImageItem זה, לשרשור

הרשאה

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

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

setWidth(width)

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

פרמטרים

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

הלוך ושוב

ImageItemImageItem זה, לשרשור

הרשאה

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

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