Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkgox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
  .setRows(['New York', 'San Francisco', 'London'])
  .setColumns(['2014', '2015', '2016', '2017']);

שיטות

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

תיעוד מפורט

clearValidation()

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

החזרות

CheckboxGridItem – הפריט הזה לשרשור

הרשאות

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

  • 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()

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

החזרות

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

הרשאות

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

  • 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[]מערך של ערכי עמודות, שאותם המשיבים רואים כתוויות בעת הצגת הטופס

החזרות

CheckboxGridItem – הפריט הזה לשרשור

קליעות

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

הרשאות

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

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

setHelpText(text)

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

פרמטרים

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

החזרות

CheckboxGridItemCheckboxGridItem, לשרשור

הרשאות

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

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

setRequired(enabled)

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

פרמטרים

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

החזרות

CheckboxGridItem – הפריט הנוכחי (לשרשור)

הרשאות

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

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

setRows(rows)

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

פרמטרים

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

החזרות

CheckboxGridItem – הפריט הזה לשרשור

קליעות

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

הרשאות

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

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

setTitle(title)

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

פרמטרים

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

החזרות

CheckboxGridItemCheckboxGridItem, לשרשור

הרשאות

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

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

setValidation(validation)

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

פרמטרים

שםתיאורהתיאור
validationCheckboxGridValidationתיבת CheckboxGridValidation שיש להחיל על פריט זה.

החזרות

CheckboxGridItemCheckboxGridItem, לשרשור

הרשאות

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

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