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[][] של מערכי ערכי 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טקסט העזרה החדש

חזרה

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

זריקות

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 או של אימות ללא קריאה לפונקציות נדרש תסיר את כל האימותים הקודמים.

פרמטרים

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

חזרה

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

אישור

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

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