Class CheckboxGridItem

CheckboxGridItem

Mục câu hỏi, được trình bày dưới dạng một lưới gồm các cột và hàng, cho phép người trả lời chọn nhiều lựa chọn cho mỗi hàng trong một chuỗi các hộp đánh dấu. Bạn có thể truy cập hoặc tạo các mục từ Form.

// Open a form by ID and add a new checkbox 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']);

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
clearValidation()CheckboxGridItemXoá mọi quy tắc xác thực dữ liệu cho mục trong lưới này.
createResponse(responses)ItemResponseTạo ItemResponse mới cho mục trong lưới hộp đánh dấu này.
duplicate()CheckboxGridItemTạo bản sao của mục này rồi thêm mục này vào cuối biểu mẫu.
getColumns()String[]Lấy giá trị cho mỗi cột trong lưới.
getHelpText()StringNhận văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItemsSectionHeaderItems).
getId()IntegerLấy giá trị nhận dạng riêng biệt của mặt hàng.
getIndex()IntegerLấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.
getRows()String[]Lấy giá trị cho mọi hàng trong lưới.
getTitle()StringLấy tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem).
getType()ItemTypeLấy loại của mục, được biểu thị dưới dạng ItemType.
isRequired()BooleanXác định xem người trả lời có phải trả lời câu hỏi hay không.
setColumns(columns)CheckboxGridItemĐặt các cột của lưới dựa trên một mảng giá trị.
setHelpText(text)CheckboxGridItemĐặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItemsSectionHeaderItems).
setRequired(enabled)CheckboxGridItemĐặt xem người trả lời có phải trả lời câu hỏi hay không.
setRows(rows)CheckboxGridItemĐặt các hàng của lưới dựa trên một mảng giá trị.
setTitle(title)CheckboxGridItemĐặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem).
setValidation(validation)CheckboxGridItemThiết lập quy tắc xác thực dữ liệu cho mục trong lưới hộp đánh dấu này.

Tài liệu chi tiết

clearValidation()

Xoá mọi quy tắc xác thực dữ liệu cho mục trong lưới này.

Cầu thủ trả bóng

CheckboxGridItem — mục này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

createResponse(responses)

Tạo ItemResponse mới cho mục trong lưới hộp đánh dấu này. Đối số responses phải là một mảng mảng String[][] có chứa số lượng giá trị bằng với số lượng đầu vào trong lưới hộp đánh dấu. Phần tử null cho câu hỏi không bắt buộc ở dạng lưới có hộp đánh dấu cho biết không có phản hồi cho hàng đó. Gửi ngoại lệ nếu bất kỳ giá trị nào không khớp với lựa chọn hợp lệ.

Tham số

TênLoạiMô tả
responsesString[][]một mảng các câu trả lời hợp lệ cho mục trong lưới hộp đánh dấu này

Cầu thủ trả bóng

ItemResponse — phản hồi về mục

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

duplicate()

Tạo bản sao của mục này rồi thêm mục này vào cuối biểu mẫu.

Cầu thủ trả bóng

CheckboxGridItem — một bản sao của CheckboxGridItem này để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getColumns()

Lấy giá trị cho mỗi cột trong lưới.

Cầu thủ trả bóng

String[] — một mảng giá trị cột mà người trả lời sẽ thấy dưới dạng nhãn khi xem biểu mẫu

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getHelpText()

Nhận văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItemsSectionHeaderItems).

Cầu thủ trả bóng

String — văn bản trợ giúp hoặc văn bản mô tả của mặt hàng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getId()

Lấy giá trị nhận dạng riêng biệt của mặt hàng.

Cầu thủ trả bóng

Integer – mã của mặt hàng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getIndex()

Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.

Cầu thủ trả bóng

Integer — chỉ mục của mục

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getRows()

Lấy giá trị cho mọi hàng trong lưới.

Cầu thủ trả bóng

String[] — một mảng giá trị hàng mà người trả lời sẽ thấy dưới dạng nhãn khi xem biểu mẫu

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getTitle()

Lấy tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem).

Cầu thủ trả bóng

String – văn bản tiêu đề hoặc tiêu đề của mặt hàng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

getType()

Lấy loại của mục, được biểu thị dưới dạng ItemType.

Cầu thủ trả bóng

ItemType – loại mục

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

isRequired()

Xác định xem người trả lời có phải trả lời câu hỏi hay không.

Cầu thủ trả bóng

Boolean — người trả lời có phải trả lời câu hỏi hay không

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

setColumns(columns)

Đặt các cột của lưới dựa trên một mảng giá trị. Gửi một ngoại lệ nếu hàm đã cho mảng trống.

Tham số

TênLoạiMô tả
columnsString[]một mảng giá trị cột mà người trả lời sẽ thấy dưới dạng nhãn khi xem biểu mẫu

Cầu thủ trả bóng

CheckboxGridItem — mục này, để tạo chuỗi

Gửi

Error – nếu mảng đã cho là null hoặc trống

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

setHelpText(text)

Đặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItemsSectionHeaderItems).

Tham số

TênLoạiMô tả
textStringvăn bản trợ giúp mới

Cầu thủ trả bóng

CheckboxGridItemCheckboxGridItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

setRequired(enabled)

Đặt xem người trả lời có phải trả lời câu hỏi hay không.

Tham số

TênLoạiMô tả
enabledBooleanliệu người trả lời có phải trả lời câu hỏi hay không

Cầu thủ trả bóng

CheckboxGridItem – mục hiện tại (để tạo chuỗi)

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

setRows(rows)

Đặt các hàng của lưới dựa trên một mảng giá trị. Gửi một ngoại lệ nếu mảng đã cho trống.

Tham số

TênLoạiMô tả
rowsString[]một mảng giá trị hàng mà người trả lời nhìn thấy dưới dạng nhãn khi xem biểu mẫu

Cầu thủ trả bóng

CheckboxGridItem — mục này, để tạo chuỗi

Gửi

Error – nếu mảng đã cho là null hoặc trống

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

setTitle(title)

Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem).

Tham số

TênLoạiMô tả
titleStringvăn bản tiêu đề hoặc tiêu đề mới

Cầu thủ trả bóng

CheckboxGridItemCheckboxGridItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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

setValidation(validation)

Thiết lập quy tắc xác thực dữ liệu cho mục trong lưới hộp đánh dấu này. Truyền giá trị rỗng hoặc xác thực mà không có mọi hàm yêu cầu được gọi sẽ xoá mọi xác thực trước đó.

Tham số

TênLoạiMô tả
validationCheckboxGridValidationCheckboxGridValidation để áp dụng cho mục này.

Cầu thủ trả bóng

CheckboxGridItemCheckboxGridItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:

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