Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkgox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 ของคำถามแบบตารางช่องทำเครื่องหมายที่ไม่จำเป็นจะระบุว่าไม่มีการตอบกลับสำหรับแถวนั้น แสดงข้อยกเว้นหากค่าใดไม่ตรงกับตัวเลือกที่ถูกต้อง

พารามิเตอร์

ชื่อTypeคำอธิบาย
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)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — สินค้านี้สำหรับการทำเชน

การขว้าง

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

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

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

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

setHelpText(text)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringข้อความช่วยเหลือใหม่

รีเทิร์น

CheckboxGridItemCheckboxGridItem นี้สำหรับการทำเชน

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

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

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

setRequired(enabled)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
enabledBooleanผู้ตอบต้องตอบคำถามนั้นหรือไม่

รีเทิร์น

CheckboxGridItem — รายการปัจจุบัน (สำหรับการทำเชน)

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

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

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

setRows(rows)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — สินค้านี้สำหรับการทำเชน

การขว้าง

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

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

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

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

setTitle(title)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
titleStringชื่อหรือข้อความส่วนหัวใหม่

รีเทิร์น

CheckboxGridItemCheckboxGridItem นี้สำหรับการทำเชน

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

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

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

setValidation(validation)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItemCheckboxGridItem นี้สำหรับการทำเชน

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

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

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