Class CheckboxItem

CheckboxItem

פריט שאלה שמאפשר למשיב לסמן תיבת סימון אחת או יותר, וגם שדה אופציונלי של 'אחר'. פריטים נוצרים או שנכנסים אליהם מתוך Form באמצעות שיטות כמו Form.addCheckboxItem(). כשמשתמשים בפריטים האלה בחידון, הם נבדקים באופן אוטומטי. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

Methods

שיטהסוג הערך שמוחזרתיאור קצר
clearValidation()CheckboxItemהסרת כל אימות נתונים עבור פריט תיבת הסימון הזה.
createChoice(value)Choiceיצירת בחירה חדשה.
createChoice(value, isCorrect)Choiceיצירת בחירה חדשה.
createResponse(responses)ItemResponseיוצרת ItemResponse חדש לפריט של תיבת הסימון.
duplicate()CheckboxItemיוצר עותק של הפריט ומצרף אותו לסוף הטופס.
getChoices()Choice[]מקבל את כל האפשרויות של פריט.
getFeedbackForCorrect()QuizFeedback|nullמחזירה את המשוב שמוצג למשיבים כשהם עונים נכון על שאלה.
getFeedbackForIncorrect()QuizFeedback|nullמחזירה את המשוב שמוצג למשיבים כשהם עונים על שאלה בצורה לא נכונה.
getHelpText()Stringמחזירה את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, ‏PageBreakItems ו-SectionHeaderItems).
getId()Integerמחזירה את המזהה הייחודי של הפריט.
getIndex()Integerמחזירה את האינדקס של הפריט מבין כל הפריטים בטופס.
getPoints()Integerהפונקציה מחזירה את סה"כ הניקוד לפריט שאפשר לתת לו ציון.
getTitle()Stringמחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).
getType()ItemTypeמחזירה את סוג הפריט, שמיוצג כ-ItemType.
hasOtherOption()Booleanקובע אם יש לפריט אפשרות 'אחר'.
isRequired()Booleanקובעת אם המשיב חייב לענות על השאלה.
setChoiceValues(values)CheckboxItemמגדירה את האפשרויות לפריט ממערך של מחרוזות.
setChoices(choices)CheckboxItemהגדרת מערך של אפשרויות לפריט.
setFeedbackForCorrect(feedback)CheckboxItemהגדרת המשוב שיוצג למשיבים כשהם עונים נכון על שאלה.
setFeedbackForIncorrect(feedback)CheckboxItemהגדרת המשוב שיוצג למשיבים אם הם ישיבו בצורה לא נכונה על שאלה.
setHelpText(text)CheckboxItemהמאפיין מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).
setPoints(points)CheckboxItemהגדרת מספר הנקודות ששווה פריט שאפשר לתת לו ציון.
setRequired(enabled)CheckboxItemהגדרה שקובעת אם המשיב חייב לענות על השאלה.
setTitle(title)CheckboxItemהגדרת שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).
setValidation(validation)CheckboxItemמגדיר את אימות הנתונים של פריט תיבת הסימון הזה.
showOtherOption(enabled)CheckboxItemמגדיר אם לפריט יש אפשרות 'אחר'.

תיעוד מפורט

clearValidation()

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

חזרה

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

אישור

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

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

createChoice(value)

יצירת בחירה חדשה.

פרמטרים

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

חזרה

Choice – הבחירה החדשה

אישור

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

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

createChoice(value, isCorrect)

יצירת בחירה חדשה.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שמוצג למשיבים כתווית כשהם צופים בטופס
isCorrectBooleanאם הבחירה היא תשובה נכונה

חזרה

Choice – הבחירה החדשה

אישור

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

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

createResponse(responses)

יוצרת ItemResponse חדש לפריט של תיבת הסימון. הארגומנט responses הוא מערך String[] שמכיל ערכים שצריך לבדוק. מוחזרת חריגה אם ערך כלשהו לא תואם לבחירה חוקית עבור הפריט הזה, אלא אם הערך של showOtherOption(enabled) הוא true.

פרמטרים

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

חזרה

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

אישור

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

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

duplicate()

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

חזרה

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

אישור

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

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

getChoices()

מקבל את כל האפשרויות של פריט.

חזרה

‫Choice[] — מגוון אפשרויות

אישור

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

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

getFeedbackForCorrect()

מחזירה את המשוב שמוצג למשיבים כשהם עונים נכון על שאלה.

חזרה

‫QuizFeedback|null – המשוב, אם יש כזה.

אישור

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

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

getFeedbackForIncorrect()

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

חזרה

‫QuizFeedback|null – המשוב, אם יש כזה.

אישור

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

  • 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

getPoints()

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

חזרה

‫Integer – מספר הנקודות ששווה תשובה נכונה לשאלה.

אישור

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

  • 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

hasOtherOption()

קובע אם יש לפריט אפשרות 'אחר'.

חזרה

‫Boolean — true אם לפריט יש אפשרות 'אחר'; false אם לא

אישור

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

  • 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

setChoiceValues(values)

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

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

פרמטרים

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

חזרה

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

אישור

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

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

setChoices(choices)

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

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

פרמטרים

שםסוגתיאור
choicesChoice[]מערך של אפשרויות

חזרה

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

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

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

אישור

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

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

setFeedbackForCorrect(feedback)

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

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setText('Dogs rule, cats drool.').build(),
);

פרמטרים

שםסוגתיאור
feedbackQuizFeedbackהמשוב החדש. ערך null ינקה את המשוב.

חזרה

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

אישור

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

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

setFeedbackForIncorrect(feedback)

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

פרמטרים

שםסוגתיאור
feedbackQuizFeedbackהמשוב החדש

חזרה

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

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

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

setPoints(points)

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

פרמטרים

שםסוגתיאור
pointsIntegerמספר הנקודות שכל פריט שאלה שווה

חזרה

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

אישור

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

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

setRequired(enabled)

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

פרמטרים

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

חזרה

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

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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

setValidation(validation)

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

פרמטרים

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

חזרה

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

אישור

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

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

showOtherOption(enabled)

מגדיר אם לפריט יש אפשרות 'אחר'. ברירת המחדל של CheckboxItem או MultipleChoiceItem חדשים היא false.

פרמטרים

שםסוגתיאור
enabledBoolean‫true אם יש לפריט אפשרות 'אחר'; false אם לא

חזרה

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

אישור

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

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