Class GridItem

GridItem

פריט שאלה שמוצג כרשת של עמודות ושורות, שמאפשר למשיב לבחור תשובה אחת לכל שורה מתוך רצף של לחצני בחירה. אפשר לגשת לפריטים או ליצור אותם מForm. 

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Methods

שיטהסוג הערך שמוחזרתיאור קצר
clearValidation()GridItemמסיר את אימות הנתונים של פריט הרשת הזה.
createResponse(responses)ItemResponseיוצרת ItemResponse חדש לפריט הזה ברשת.
duplicate()GridItemיוצר עותק של הפריט ומצרף אותו לסוף הטופס.
getColumns()String[]מחזירה את הערכים של כל העמודות ברשת.
getHelpText()Stringמחזירה את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, ‏PageBreakItems ו-SectionHeaderItems).
getId()Integerמחזירה את המזהה הייחודי של הפריט.
getIndex()Integerמחזירה את האינדקס של הפריט מבין כל הפריטים בטופס.
getRows()String[]מקבל את הערכים של כל שורה ברשת.
getTitle()Stringמחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).
getType()ItemTypeמחזירה את סוג הפריט, שמיוצג כ-ItemType.
isRequired()Booleanקובעת אם המשיב חייב לענות על השאלה.
setColumns(columns)GridItemהפונקציה מגדירה את העמודות של הרשת על סמך מערך של ערכים.
setHelpText(text)GridItemהמאפיין מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).
setRequired(enabled)GridItemהגדרה שקובעת אם המשיב חייב לענות על השאלה.
setRows(rows)GridItemהפונקציה מגדירה את השורות של הרשת על סמך מערך של ערכים.
setTitle(title)GridItemהגדרת שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).
setValidation(validation)GridItemמגדירה את אימות הנתונים של פריט הרשת הזה.

תיעוד מפורט

clearValidation()

מסיר את אימות הנתונים של פריט הרשת הזה.

חזרה

‫GridItem – הפריט הזה, לשרשור

אישור

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

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

createResponse(responses)

יוצרת ItemResponse חדש לפריט הזה ברשת. הארגומנט responses צריך להיות מערך String[] שמכיל מספר ערכים ששווה למספר השורות ברשת. רכיב null בשאלת רשת לא חובה מציין שלא ניתנה תשובה לשורה הזו. הפונקציה יוצרת חריגה אם אף אחד מהערכים לא תואם לבחירה חוקית.

פרמטרים

שםסוגתיאור
responsesString[]מערך של תשובות תקינות לפריט הרשת הזה

חזרה

‫ItemResponse – התשובה לפריט

אישור

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

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

duplicate()

יוצר עותק של הפריט ומצרף אותו לסוף הטופס.

חזרה

‫GridItem – עותק משוכפל של GridItem, לשרשור

אישור

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

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

getColumns()

מחזירה את הערכים של כל העמודות ברשת.

חזרה

‫String[] – מערך של ערכי עמודות, שהמשיבים רואים כתוויות כשהם צופים בטופס

אישור

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

  • 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

getIndex()

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

חזרה

‫Integer – האינדקס של הפריט

אישור

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

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

getRows()

מקבל את הערכים של כל שורה ברשת.

חזרה

‫String[] – מערך של ערכי שורות, שהמשיבים רואים כתוויות כשהם צופים בטופס

אישור

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

  • 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

isRequired()

קובעת אם המשיב חייב לענות על השאלה.

חזרה

‫Boolean – האם המשיב חייב לענות על השאלה

אישור

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

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

setColumns(columns)

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

פרמטרים

שםסוגתיאור
columnsString[]מערך של ערכי עמודות, שהמשיבים רואים כתוויות כשהם צופים בטופס

חזרה

‫GridItem – הפריט הזה, לשרשור

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם המערך הנתון הוא null או ריק

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

‫GridItem — GridItem הזה, לשרשור

אישור

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

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

setRequired(enabled)

הגדרה שקובעת אם המשיב חייב לענות על השאלה.

פרמטרים

שםסוגתיאור
enabledBooleanהאם המשיב חייב לענות על השאלה

חזרה

‫GridItem — הפריט הנוכחי (לשרשור)

אישור

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

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

setRows(rows)

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

פרמטרים

שםסוגתיאור
rowsString[]מערך של ערכי שורות, שהמשיבים רואים כתוויות כשהם צופים בטופס

חזרה

‫GridItem – הפריט הזה, לשרשור

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם המערך הנתון הוא null או ריק

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

‫GridItem — GridItem הזה, לשרשור

אישור

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

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

setValidation(validation)

מגדירה את אימות הנתונים של פריט הרשת הזה. העברה של null או של מופע GridValidation שלא הופעלו בו פונקציות require, מסירה את כל האימות הקודם.

פרמטרים

שםסוגתיאור
validationGridValidation‫GridValidation שיש להחיל על הפריט הזה.

חזרה

‫GridItem — GridItem הזה, לשרשור

אישור

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

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