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 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']);
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 trong lưới này. |
createResponse(responses) | ItemResponse | Tạo ItemResponse mới cho mục trong lưới hộp đánh dấu này. |
duplicate() | CheckboxGridItem | 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. |
getColumns() | String[] | Lấy giá trị cho mỗi cột trong lưới. |
getHelpText() | String | 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 , PageBreakItems và SectionHeaderItems ). |
getId() | Integer | Lấy giá trị nhận dạng riêng biệ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 là 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 là SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | 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. |
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ên | Loại | Mô tả |
---|---|---|
responses | String[][] | 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
, 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ặ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()
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ên | Loại | Mô tả |
---|---|---|
columns | 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 |
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
, 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
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ê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
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ên | Loại | Mô tả |
---|---|---|
rows | String[] | 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ên | Loại | Mô tả |
---|---|---|
title | String | văn bản tiêu đề hoặc tiêu đề mới |
Cầu thủ trả bóng
CheckboxGridItem
— 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
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ên | Loại | Mô tả |
---|---|---|
validation | CheckboxGridValidation | 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
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