Class Choice

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(),
  );
}

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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 หากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getPageNavigationType()

รับ PageNavigationType ที่เกิดขึ้นหากผู้ตอบเลือกตัวเลือกนี้และดำเนินการในหน้าปัจจุบันจนเสร็จสมบูรณ์ วิธีการนี้ใช้ได้กับตัวเลือกที่เชื่อมโยงกับ MultipleChoiceItems เท่านั้น ส่วนตัวเลือกอื่นๆ จะแสดงผลเป็น null

รีเทิร์น

PageNavigationType — การนําทางสําหรับตัวเลือกนี้ หรือ null หากไม่มี

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getValue()

รับค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม

รีเทิร์น

String — ค่าของตัวเลือก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isCorrectAnswer()

รับว่าตัวเลือกเป็นคำตอบที่ถูกต้องสำหรับคำถามหรือไม่ เมธอดนี้ใช้ได้กับคำถามที่เป็นส่วนหนึ่งของแบบทดสอบเท่านั้น ส่วนแบบฟอร์มที่ไม่ใช่แบบทดสอบจะแสดงผลเป็นเท็จ

รีเทิร์น

Boolean — ตัวเลือกเป็นคำตอบที่ถูกต้องหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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