Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkbox 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טקסט העזרה החדש

חזרה

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

פרמטרים

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

חזרה

CheckboxGridItem – הCheckboxGridItem הזה, לשרשור

אישור

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

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