Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
    .setRows(['New York', 'San Francisco', 'London'])
    .setColumns(['2014', '2015', '2016', '2017']);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
clearValidation()CheckboxGridItemนำการตรวจสอบข้อมูลของรายการตารางกริดนี้ออก
createResponse(responses)ItemResponseสร้าง ItemResponse ใหม่สำหรับรายการตารางกริดช่องทําเครื่องหมายนี้
duplicate()CheckboxGridItemสร้างสำเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม
getColumns()String[]รับค่าสําหรับทุกคอลัมน์ในตารางกริด
getHelpText()Stringรับข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
getId()Integerรับตัวระบุที่ไม่ซ้ำกันของรายการ
getIndex()Integerรับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม
getRows()String[]รับค่าของทุกแถวในตารางกริด
getTitle()Stringรับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)
getType()ItemTypeรับประเภทของรายการซึ่งแสดงเป็น ItemType
isRequired()Booleanกำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setColumns(columns)CheckboxGridItemตั้งค่าคอลัมน์ของตารางกริดตามอาร์เรย์ของค่า
setHelpText(text)CheckboxGridItemตั้งค่าข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
setRequired(enabled)CheckboxGridItemตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่
setRows(rows)CheckboxGridItemตั้งค่าแถวของตารางกริดตามอาร์เรย์ของค่า
setTitle(title)CheckboxGridItemตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)
setValidation(validation)CheckboxGridItemตั้งค่าการตรวจสอบข้อมูลสําหรับรายการตารางกริดช่องทําเครื่องหมายนี้

เอกสารประกอบโดยละเอียด

clearValidation()

นำการตรวจสอบข้อมูลของรายการตารางกริดนี้ออก

รีเทิร์น

CheckboxGridItem — รายการนี้สําหรับการต่อเชื่อม

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

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

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

createResponse(responses)

สร้าง ItemResponse ใหม่สำหรับรายการตารางกริดช่องทําเครื่องหมายนี้ อาร์กิวเมนต์ responses ต้องเป็นรูปหลายเหลี่ยม String[][] ของอาร์เรย์ที่มีค่าเท่ากับจํานวนอินพุตในตารางช่องทําเครื่องหมาย องค์ประกอบ null สำหรับตารางคำถามแบบช่องทำเครื่องหมายที่ไม่บังคับบ่งชี้ว่าไม่มีคำตอบในแถวนั้น แสดงข้อยกเว้นหากค่าใดไม่ตรงกับตัวเลือกที่ถูกต้อง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
responsesString[][]อาร์เรย์ของอาร์เรย์คำตอบที่ถูกต้องสำหรับรายการตารางคำถามแบบช่องทำเครื่องหมายนี้

รีเทิร์น

ItemResponse — การตอบกลับรายการ

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

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

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

duplicate()

สร้างสำเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม

รีเทิร์น

CheckboxGridItem — รายการ CheckboxGridItem รายการนี้ซ้ำกันสำหรับใช้ต่อท้าย

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

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

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

getColumns()

รับค่าสําหรับทุกคอลัมน์ในตารางกริด

รีเทิร์น

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

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

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

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

getHelpText()

รับข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)

รีเทิร์น

String — ข้อความความช่วยเหลือหรือข้อความอธิบายของรายการ

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

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

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

getId()

รับตัวระบุที่ไม่ซ้ำกันของรายการ

รีเทิร์น

Integer — รหัสของสินค้า

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

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

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

getIndex()

รับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม

รีเทิร์น

Integer — ดัชนีของรายการ

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

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

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

getRows()

รับค่าของทุกแถวในตารางกริด

รีเทิร์น

String[] — อาร์เรย์ของค่าแถวที่ผู้ตอบเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม

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

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

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

getTitle()

รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)

รีเทิร์น

String — ชื่อหรือข้อความส่วนหัวของสินค้า

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

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

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

getType()

รับประเภทของรายการซึ่งแสดงเป็น ItemType

รีเทิร์น

ItemType — ประเภทของรายการ

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

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

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

isRequired()

กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่

รีเทิร์น

Boolean — ผู้ตอบต้องตอบคำถามหรือไม่

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

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

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

setColumns(columns)

ตั้งค่าคอลัมน์ของตารางกริดตามอาร์เรย์ของค่า โยนข้อยกเว้นหากอาร์เรย์ที่ระบุว่างเปล่า

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnsString[]อาร์เรย์ของค่าคอลัมน์ ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม

รีเทิร์น

CheckboxGridItem — รายการนี้สําหรับการต่อเชื่อม

โยน

Error — หากอาร์เรย์ที่ระบุเป็น null หรือว่าง

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

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

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

setHelpText(text)

ตั้งค่าข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความช่วยเหลือใหม่

รีเทิร์น

CheckboxGridItem — CheckboxGridItem นี้สําหรับการเชน

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

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

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

setRequired(enabled)

ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleanผู้ตอบต้องตอบคำถามหรือไม่

รีเทิร์น

CheckboxGridItem — รายการปัจจุบัน (สำหรับการต่อเชื่อม)

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

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

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

setRows(rows)

ตั้งค่าแถวของตารางกริดตามอาร์เรย์ของค่า โยนข้อยกเว้นหากอาร์เรย์ที่ระบุว่างเปล่า

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rowsString[]อาร์เรย์ของค่าแถวที่ผู้ตอบเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม

รีเทิร์น

CheckboxGridItem — รายการนี้สําหรับการต่อเชื่อม

โยน

Error — หากอาร์เรย์ที่ระบุเป็น null หรือว่าง

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

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

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

setTitle(title)

ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อหรือข้อความส่วนหัวใหม่

รีเทิร์น

CheckboxGridItem — CheckboxGridItem นี้สําหรับการเชน

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

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

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

setValidation(validation)

ตั้งค่าการตรวจสอบข้อมูลสําหรับรายการตารางกริดช่องทําเครื่องหมายนี้ การส่งค่า Null หรือการตรวจสอบโดยไม่เรียกใช้ฟังก์ชันที่จำเป็นใดๆ จะนําการตรวจสอบก่อนหน้าออก

พารามิเตอร์

ชื่อประเภทคำอธิบาย
validationCheckboxGridValidationCheckboxGridValidation เพื่อใช้กับรายการนี้

รีเทิร์น

CheckboxGridItem — CheckboxGridItem นี้สําหรับการเชน

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

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

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