این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class Choice

یک انتخاب منفرد مرتبط با نوعی از Item که از گزینه‌هایی مانند Checkbox Item ، List Item یا Multiple Choice Item پشتیبانی می‌کند.

// 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`	دریافت می کند که آیا انتخاب پاسخ صحیحی برای سؤال است یا خیر.

مستندات دقیق

`get Goto Page()`

اگر پاسخ دهنده این گزینه را انتخاب کرده و صفحه فعلی را تکمیل کند، Page Break Item را به عنوان مقصد GO_TO_PAGE تنظیم می کند. این روش فقط برای انتخاب های مرتبط با Multiple Choice Items اعمال می شود. برای انتخاب های دیگر، null برمی گرداند.

بازگشت

Page Break Item — مقصد GO_TO_PAGE برای این انتخاب، یا اگر وجود نداشته باشد، null

مجوز

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

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

`get Page Navigation Type()`

در صورتی که پاسخ دهنده این گزینه را انتخاب کرده و صفحه فعلی را تکمیل کند، Page Navigation Type را دریافت می کند. این روش فقط برای انتخاب های مرتبط با Multiple Choice Items اعمال می شود. for other choices, it returns null .

بازگشت

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

مجوز

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

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

`get Value()`

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

بازگشت

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

مجوز

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

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

`is Correct Answer()`

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

بازگشت

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

مجوز

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

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