Class Choice

انتخاب

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

// Create a new form and add a multiple-choice item.
const form = FormApp.create('Form Name');
const 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.
const choices = item.getChoices();
for (let i = 0; i < choices.length; i++) {
  Logger.log(
      'If the respondent chooses "%s", the form will %s.',
      choices[i].getValue(),
      choices[i].getPageNavigationType(),
  );
}

روش‌ها

روش نوع بازگشتی شرح مختصر
get Goto Page() Page Break Item اگر پاسخ‌دهنده این گزینه را انتخاب کند و صفحه فعلی را تکمیل کند، Page Break Item به عنوان مقصد GO_TO_PAGE تنظیم می‌کند.
get Page Navigation Type() Page Navigation Type Page Navigation Type برمی‌گرداند که اگر پاسخ‌دهنده این گزینه را انتخاب کند و صفحه فعلی را تکمیل کند، رخ می‌دهد.
get Value() String مقدار انتخاب را دریافت می‌کند، که پاسخ‌دهندگان هنگام مشاهده فرم آن را به عنوان یک برچسب می‌بینند.
is Correct Answer() 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