Class CheckboxItem

תיבת סימוןפריט

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

// 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, לשרשור

זריקות

‫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().setDisplayText('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 תסיר כל אימות קודם.

פרמטרים

שםסוגתיאור
validationCheckboxValidation‫CheckboxValidation כדי להחיל על הפריט הזה.

חזרה

‫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