Class Choice

انتخاب

یک انتخاب واحد مرتبط با یک نوع Item که از انتخاب‌هایی مانند CheckboxItem ، ListItem یا MultipleChoiceItem پشتیبانی می‌کند.

// Create a new form and add a multiple-choice item.
var form = FormApp.create('Form Name');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),
        item.createChoice('Dogs', FormApp.PageNavigationType.RESTART)
    ]);

// Add another page because navigation has no effect on the last page.
form.addPageBreakItem().setTitle('You chose well!');

// Log the navigation types that each choice results in.
var choices = item.getChoices();
for (var i = 0; i < choices.length; i++) {
Logger.log('If the respondent chooses "%s", the form will %s.',
           choices[i].getValue(),
           choices[i].getPageNavigationType());
}

مواد و روش ها

روش نوع برگشت توضیح مختصر
getGotoPage() PageBreakItem اگر پاسخ دهنده این گزینه را انتخاب کرده و صفحه فعلی را تکمیل کند، PageBreakItem به عنوان مقصد GO_TO_PAGE تنظیم می کند.
getPageNavigationType() PageNavigationType PageNavigationType را دریافت می‌کند که اگر پاسخ‌دهنده این گزینه را انتخاب کرده و صفحه فعلی را تکمیل کند، رخ می‌دهد.
getValue() String مقدار انتخاب را دریافت می کند، که پاسخ دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می بینند.
isCorrectAnswer() Boolean دریافت می کند که آیا انتخاب پاسخ صحیحی برای سؤال است یا خیر.

مستندات دقیق

getGotoPage()

اگر پاسخ دهنده این گزینه را انتخاب کرده و صفحه فعلی را تکمیل کند، PageBreakItem به عنوان مقصد GO_TO_PAGE تنظیم می کند. این روش فقط برای انتخاب های مرتبط با MultipleChoiceItems اعمال می شود. برای انتخاب های دیگر، null برمی گرداند.

برگشت

PageBreakItem - مقصد GO_TO_PAGE برای این انتخاب، یا اگر وجود نداشته باشد null

مجوز

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

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

getPageNavigationType()

PageNavigationType را دریافت می‌کند که اگر پاسخ‌دهنده این گزینه را انتخاب کرده و صفحه فعلی را تکمیل کند، رخ می‌دهد. این روش فقط برای انتخاب های مرتبط با MultipleChoiceItems اعمال می شود. برای انتخاب های دیگر، null برمی گرداند.

برگشت

PageNavigationType - عمل ناوبری برای این انتخاب، یا اگر وجود نداشته باشد null است

مجوز

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

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

getValue()

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

برگشت

String - مقدار انتخاب

مجوز

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

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

isCorrectAnswer()

دریافت می کند که آیا انتخاب پاسخ صحیحی برای سؤال است یا خیر. این روش فقط برای سوالاتی اعمال می شود که بخشی از یک مسابقه هستند. برای فرم های غیر آزمون، false را برمی گرداند.

برگشت

Boolean - اینکه آیا انتخاب یک پاسخ صحیح است یا خیر.

مجوز

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

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