Trang này được dịch bởi Cloud Translation API.

Class CheckboxGridItem

Một mục câu hỏi, được trình bày dưới dạng 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 trên mỗi hàng trong một chuỗi 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.
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']);

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`clearValidation()`	`CheckboxGridItem`	Xoá mọi quy tắc xác thực dữ liệu cho mục lưới này.
`createResponse(responses)`	`ItemResponse`	Tạo một `ItemResponse` mới cho mục lưới hộp đánh dấu này.
`duplicate()`	`CheckboxGridItem`	Tạo một bản sao của mục này và thêm vào cuối biểu mẫu.
`getColumns()`	`String[]`	Lấy giá trị cho mọi cột trong lưới.
`getHelpText()`	`String`	Lấy 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`, `PageBreakItems` và `SectionHeaderItems`).
`getId()`	`Integer`	Lấy giá trị nhận dạng duy nhất của mặt hàng.
`getIndex()`	`Integer`	Lấ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()`	`String`	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 của `SectionHeaderItem`).
`getType()`	`ItemType`	Lấy loại của mục, được biểu thị dưới dạng `ItemType`.
`isRequired()`	`Boolean`	Xá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`, `PageBreakItems` và `SectionHeaderItems`).
`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 của `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxGridItem`	Thiết lập quy trình xác thực dữ liệu cho mục 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 lưới này.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 một ItemResponse mới cho mục lưới hộp đánh dấu này. Đối số responses phải là một mảng String[][] gồm các mảng chứa số lượng giá trị bằng số lượng dữ liệu đầu vào trong lưới hộp đánh dấu. Phần tử null cho câu hỏi dạng lưới hộp đánh dấu không bắt buộc cho biết không có câu trả lời nào cho hàng đó. Gửi một 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ên	Loại	Mô tả
`responses`	`String[][]`	một mảng các mảng câu trả lời hợp lệ cho mục lưới hộp đánh dấu này

Cầu thủ trả bóng

ItemResponse – phản hồi về mặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 một bản sao của mục này và thêm vào cuối biểu mẫu.

Cầu thủ trả bóng

CheckboxGridItem – bản sao của CheckboxGridItem này, để tạo chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 các giá trị cột mà người trả lời nhìn thấy dưới dạng nhãn khi xem biểu mẫu

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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()`

Lấy 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, PageBreakItems và SectionHeaderItems).

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ục

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 duy nhất của mặt hàng.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 các giá trị hàng mà người trả lời thấy dưới dạng nhãn khi xem biểu mẫu

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của SectionHeaderItem).

Cầu thủ trả bóng

String – tiêu đề hoặc văn bản tiêu đề của mục

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của mục

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 – liệu người trả lời có phải trả lời câu hỏi hay không

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 mảng đã cho trống.

Tham số

Tên	Loại	Mô tả
`columns`	`String[]`	một mảng các giá trị cột 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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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, PageBreakItems và SectionHeaderItems).

Tham số

Tên	Loại	Mô tả
`text`	`String`	văn bản trợ giúp mới

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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ên	Loại	Mô tả
`enabled`	`Boolean`	liệ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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 trường hợp ngoại lệ nếu mảng đã cho trống.

Tham số

Tên	Loại	Mô tả
`rows`	`String[]`	một mảng các 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

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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 của SectionHeaderItem).

Tham số

Tên	Loại	Mô tả
`title`	`String`	tiêu đề hoặc văn bản tiêu đề mới

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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 trình xác thực dữ liệu cho mục lưới hộp đánh dấu này. Việc truyền giá trị rỗng hoặc giá trị xác thực mà không có hàm yêu cầu nào được gọi sẽ xoá mọi giá trị xác thực trước đó.

Tham số

Tên	Loại	Mô tả
`validation`	`CheckboxGridValidation`	một CheckboxGridValidation để áp dụng cho mục này.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ 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