หน้านี้ได้รับการแปลโดย Cloud Translation API

Class CheckboxItem

รายการคำถามที่ช่วยให้ผู้ตอบเลือกช่องทำเครื่องหมายได้อย่างน้อย 1 ช่อง รวมถึง ไม่บังคับ "อื่นๆ" ด้วย คุณสามารถเข้าถึงหรือสร้างรายการจาก 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 นี้สำหรับการทำห่วงโซ่

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

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

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`	ความคิดเห็นใหม่ ค่า Null จะล้างความคิดเห็น

รีเทิร์น

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`	CheckboxValidation เพื่อใช้กับรายการนี้

รีเทิร์น

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