Class CheckboxGridItem

CheckboxGridItem

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

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

Methods

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

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

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

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

  • 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 – הפריט הזה, לשרשור

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

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

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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

setValidation(validation)

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

פרמטרים

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

חזרה

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

אישור

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

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