Class CheckboxItem

Checkbox Item

یک مورد سوالی که به پاسخ دهنده اجازه می دهد یک یا چند کادر انتخاب و همچنین یک فیلد اختیاری "دیگر" را انتخاب کند. آیتم ها را می توان از یک Form مشاهده کرد یا ایجاد کرد. هنگامی که در یک مسابقه استفاده می شود، این موارد به صورت خودکار درجه بندی می شوند. 

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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);

روش ها

روش نوع برگشت شرح مختصر
clearValidation() CheckboxItem هر گونه اعتبارسنجی داده را برای این مورد چک باکس حذف می کند.
createChoice(value) Choice انتخاب جدیدی ایجاد می کند.
createChoice(value, isCorrect) Choice انتخاب جدیدی ایجاد می کند.
createResponse(responses) ItemResponse یک ItemResponse جدید برای این آیتم چک باکس ایجاد می کند.
duplicate() CheckboxItem یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
getChoices() Choice[] همه انتخاب ها را برای یک مورد دریافت می کند.
getFeedbackForCorrect() QuizFeedback بازخوردی را برمی‌گرداند که به پاسخ‌دهندگان در صورت پاسخ صحیح به یک سؤال نشان داده می‌شود.
getFeedbackForIncorrect() QuizFeedback بازخوردی را برمی‌گرداند که وقتی پاسخ‌دهندگان به سؤالی نادرست پاسخ می‌دهند به آنها نشان داده می‌شود.
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)

انتخاب جدیدی ایجاد می کند.

پارامترها

نام تایپ کنید توضیحات
value String مقدار انتخاب، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می بینند

بازگشت

Choice - انتخاب جدید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

createChoice(value, isCorrect)

انتخاب جدیدی ایجاد می کند.

پارامترها

نام تایپ کنید توضیحات
value String مقدار انتخاب، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می بینند
isCorrect Boolean آیا انتخاب یک پاسخ صحیح است

بازگشت

Choice - انتخاب جدید

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

createResponse(responses)

یک ItemResponse جدید برای این آیتم چک باکس ایجاد می کند. responses آرگومان یک آرایه String[] حاوی مقادیری است که باید بررسی شوند. اگر مقداری با یک انتخاب معتبر برای این مورد مطابقت نداشته باشد، استثنا می‌کند، مگر اینکه showOtherOption(enabled) روی true تنظیم شده باشد.

پارامترها

نام تایپ کنید توضیحات
responses String[] مجموعه ای از پاسخ های معتبر برای این مورد چند گزینه ای

بازگشت

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 - بازخورد، در صورت وجود.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

getFeedbackForIncorrect()

بازخوردی را برمی‌گرداند که وقتی پاسخ‌دهندگان به سؤالی نادرست پاسخ می‌دهند به آنها نشان داده می‌شود.

بازگشت

QuizFeedback - بازخورد، در صورت وجود.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

پارامترها

نام تایپ کنید توضیحات
values String[] آرایه مقادیر انتخابی، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان برچسب می بینند

بازگشت

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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

پارامترها

نام تایپ کنید توضیحات
choices Choice[] مجموعه ای از انتخاب ها

بازگشت

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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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());

پارامترها

نام تایپ کنید توضیحات
feedback QuizFeedback بازخورد جدید یک مقدار تهی بازخورد را پاک می کند.

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

setFeedbackForIncorrect(feedback)

بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤالی نادرست پاسخ می دهند، به آنها نشان داده شود.

پارامترها

نام تایپ کنید توضیحات
feedback QuizFeedback بازخورد جدید

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

setHelpText(text)

متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند ImageItems ، PageBreakItems و SectionHeaderItems نامیده می‌شود).

پارامترها

نام تایپ کنید توضیحات
text String متن راهنما جدید

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

setPoints(points)

تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.

پارامترها

نام تایپ کنید توضیحات
points Integer تعداد امتیاز یک مورد سوال ارزش دارد

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

setRequired(enabled)

تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.

پارامترها

نام تایپ کنید توضیحات
enabled Boolean آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

بازگشت

CheckboxItem - مورد فعلی (برای زنجیر کردن)

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

setTitle(title)

عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد SectionHeaderItem ).

پارامترها

نام تایپ کنید توضیحات
title String عنوان یا متن سرصفحه جدید

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

setValidation(validation)

اعتبار سنجی داده را برای این مورد چک باکس تنظیم می کند. ارسال null یا اعتبارسنجی بدون نیاز به توابع فراخوانی شده، هرگونه اعتبارسنجی قبلی را حذف می کند.

پارامترها

نام تایپ کنید توضیحات
validation CheckboxValidation یک Checkbox Validation برای اعمال به این مورد.

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

showOtherOption(enabled)

تنظیم می کند که آیا مورد گزینه "دیگر" داشته باشد یا خیر. پیش فرض یک CheckboxItem یا MultipleChoiceItem جدید false است.

پارامترها

نام تایپ کنید توضیحات
enabled Boolean true اگر مورد گزینه "دیگر" داشته باشد. false اگر نه

بازگشت

CheckboxItem - این CheckboxItem ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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