Class GridItem

Mụclưới

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 một lựa chọn cho mỗi hàng trong một chuỗi nút chọn. Bạn có thể truy cập hoặc tạo các mục từ một Form. 

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
clearValidation()GridItemXoá mọi quy tắc xác thực dữ liệu cho mục lưới này.
createResponse(responses)ItemResponseTạo một ItemResponse mới cho mục này trong lưới.
duplicate()GridItemTạ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 các giá trị cho mọi cột trong lưới.
getHelpText()StringLấ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()IntegerLấy giá trị nhận dạng duy nhấ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 các 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 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ó bắt buộc phải trả lời câu hỏi hay không.
setColumns(columns)GridItemĐặt các cột của lưới dựa trên một mảng giá trị.
setHelpText(text)GridItemĐặ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)GridItemĐặt xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.
setRows(rows)GridItemĐặt các hàng của lưới dựa trên một mảng giá trị.
setTitle(title)GridItemĐặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem).
setValidation(validation)GridItemĐặt chế độ xác thực dữ liệu cho mục này trong lưới.

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

GridItem – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 này trong lưới. Đối số responses phải là một mảng String[] chứa nhiều giá trị bằng số hàng trong lưới. Phần tử null cho một câu hỏi lưới không bắt buộc cho biết không có câu trả lời cho hàng đó. Gây ra một ngoại lệ nếu bất kỳ giá trị nào không khớp với một lựa chọn hợp lệ.

Thông số

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

Cầu thủ trả bóng

ItemResponse – phản hồi của mục

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

GridItem – bản sao của GridItem này, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getColumns()

Lấy các 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ã nhận dạng của mặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getRows()

Lấy các 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 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 SectionHeaderItem).

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

isRequired()

Xác định xem người trả lời có bắt buộ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ó bắt buộ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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ị. Trả về một trường hợp ngoại lệ nếu mảng đã cho bị trống.

Thông số

TênLoạiMô tả
columnsString[]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

GridItem – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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).

Thông số

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

Cầu thủ trả bóng

GridItem – GridItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setRequired(enabled)

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

Thông số

TênLoạiMô tả
enabledBooleanngười trả lời có bắt buộc phải trả lời câu hỏi hay không

Cầu thủ trả bóng

GridItem – mục hiện tại (để liên kết)

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ị. Trả về một trường hợp ngoại lệ nếu mảng đã cho bị trống.

Thông số

TênLoạiMô tả
rowsString[]một mảng các 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

GridItem – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 SectionHeaderItem).

Thông số

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

Cầu thủ trả bóng

GridItem – GridItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setValidation(validation)

Đặt chế độ xác thực dữ liệu cho mục này trong lưới. Việc truyền vào null hoặc một phiên bản GridValidation mà không có hàm yêu cầu nào được gọi sẽ xoá mọi hoạt động xác thực trước đó.

Thông số

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

Cầu thủ trả bóng

GridItem – GridItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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