Class CheckboxItem

CheckboxItem

Một mục câu hỏi cho phép người trả lời chọn một hoặc nhiều hộp đánh dấu, cũng như một trường "khác" không bắt buộc. Các mục được tạo hoặc truy cập từ một Form bằng cách sử dụng các phương thức như Form.addCheckboxItem(). Khi được dùng trong bài kiểm tra, những mục này sẽ được chấm điểm tự động. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
clearValidation()CheckboxItemXoá mọi quy tắc xác thực dữ liệu cho mục hộp đánh dấu này.
createChoice(value)ChoiceTạo một lựa chọn mới.
createChoice(value, isCorrect)ChoiceTạo một lựa chọn mới.
createResponse(responses)ItemResponseTạo một ItemResponse mới cho mục hộp đánh dấu này.
duplicate()CheckboxItemTạo một bản sao của mục này và thêm bản sao đó vào cuối biểu mẫu.
getChoices()Choice[]Lấy tất cả các lựa chọn cho một mục.
getFeedbackForCorrect()QuizFeedback|nullTrả về thông tin phản hồi mà người trả lời nhìn thấy khi họ trả lời đúng một câu hỏi.
getFeedbackForIncorrect()QuizFeedback|nullTrả về ý kiến phản hồi được hiển thị cho người trả lời khi họ trả lời sai một câu hỏ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.
getPoints()IntegerTrả về giá trị điểm của một mục có thể chấm điểm.
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.
hasOtherOption()BooleanXác định xem mặt hàng có lựa chọn "khác" hay không.
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.
setChoiceValues(values)CheckboxItemĐặt các lựa chọn cho một mục trong mảng chuỗi.
setChoices(choices)CheckboxItemĐặt một mảng lựa chọn cho một mục.
setFeedbackForCorrect(feedback)CheckboxItemĐặt thông tin phản hồi sẽ hiển thị cho người trả lời khi họ trả lời đúng một câu hỏi.
setFeedbackForIncorrect(feedback)CheckboxItemĐặt thông tin phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai một câu hỏi.
setHelpText(text)CheckboxItemĐặ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).
setPoints(points)CheckboxItemĐặt số điểm tương ứng cho một mục có thể chấm điểm.
setRequired(enabled)CheckboxItemĐặt xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.
setTitle(title)CheckboxItemĐặ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)CheckboxItemĐặt quy tắc xác thực dữ liệu cho mục hộp đánh dấu này.
showOtherOption(enabled)CheckboxItemĐặt xem mặt hàng có lựa chọn "khác" hay không.

Tài liệu chi tiết

clearValidation()

Xoá mọi quy tắc xác thực dữ liệu cho mục hộp đánh dấu này.

Cầu thủ trả bóng

CheckboxItem – CheckboxItem 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

createChoice(value)

Tạo một lựa chọn mới.

Thông số

TênLoạiMô tả
valueStringgiá trị của lựa chọn, mà người trả lời thấy dưới dạng nhãn khi xem biểu mẫu

Cầu thủ trả bóng

Choice – lựa chọn mớ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

createChoice(value, isCorrect)

Tạo một lựa chọn mới.

Thông số

TênLoạiMô tả
valueStringgiá trị của lựa chọn, mà người trả lời thấy dưới dạng nhãn khi xem biểu mẫu
isCorrectBooleanlựa chọn đó có phải là câu trả lời đúng hay không

Cầu thủ trả bóng

Choice – lựa chọn mớ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 hộp đánh dấu này. Đối số responses là một mảng String[] chứa các giá trị cần kiểm tra. Gửi một ngoại lệ nếu có giá trị không khớp với lựa chọn hợp lệ cho mục này, trừ phi showOtherOption(enabled) được đặt thành true.

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 trắc nghiệm 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 bản sao đó vào cuối biểu mẫu.

Cầu thủ trả bóng

CheckboxItem – bản sao của CheckboxItem 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

getChoices()

Lấy tất cả các lựa chọn cho một mục.

Cầu thủ trả bóng

Choice[] – một mảng các lựa chọn

Ủ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