Halaman ini diterjemahkan oleh Cloud Translation API.

Class CheckboxItem

Item pertanyaan yang memungkinkan responden memilih satu atau beberapa kotak centang, serta kolom "lainnya&quot opsional. Item dapat diakses atau dibuat dari Form. Saat digunakan dalam kuis, item ini dinilai secara otomatis.

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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);

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`clearValidation()`	`CheckboxItem`	Menghapus validasi data untuk item kotak centang ini.
`createChoice(value)`	`Choice`	Membuat pilihan baru.
`createChoice(value, isCorrect)`	`Choice`	Membuat pilihan baru.
`createResponse(responses)`	`ItemResponse`	Membuat `ItemResponse` baru untuk item kotak centang ini.
`duplicate()`	`CheckboxItem`	Membuat salinan item ini dan menambahkannya ke akhir formulir.
`getChoices()`	`Choice[]`	Mendapatkan semua pilihan untuk sebuah item.
`getFeedbackForCorrect()`	`QuizFeedback`	Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
`getFeedbackForIncorrect()`	`QuizFeedback`	Menampilkan masukan yang ditampilkan kepada responden jika mereka salah menjawab pertanyaan.
`getHelpText()`	`String`	Mendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti `ImageItems`, `PageBreakItems`, dan `SectionHeaderItems`).
`getId()`	`Integer`	Mendapatkan ID unik item.
`getIndex()`	`Integer`	Mendapatkan indeks item di antara semua item dalam formulir.
`getPoints()`	`Integer`	Menampilkan nilai poin dari item yang dapat dinilai.
`getTitle()`	`String`	Mendapatkan judul item (terkadang disebut teks header, untuk `SectionHeaderItem`).
`getType()`	`ItemType`	Mendapatkan jenis item, yang direpresentasikan sebagai `ItemType`.
`hasOtherOption()`	`Boolean`	Menentukan apakah item memiliki opsi "lainnya".
`isRequired()`	`Boolean`	Menentukan apakah responden harus menjawab pertanyaan atau tidak.
`setChoiceValues(values)`	`CheckboxItem`	Menetapkan pilihan untuk item dari array string.
`setChoices(choices)`	`CheckboxItem`	Menetapkan array pilihan untuk sebuah item.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Menetapkan masukan untuk ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Setel masukan untuk ditampilkan kepada responden saat mereka salah menjawab pertanyaan.
`setHelpText(text)`	`CheckboxItem`	Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti `ImageItems`, `PageBreakItems`, dan `SectionHeaderItems`).
`setPoints(points)`	`CheckboxItem`	Menetapkan jumlah poin untuk item yang dapat dinilai.
`setRequired(enabled)`	`CheckboxItem`	Menetapkan apakah responden harus menjawab pertanyaan.
`setTitle(title)`	`CheckboxItem`	Menetapkan judul item (terkadang disebut teks header, untuk `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	Menetapkan validasi data untuk item kotak centang ini.
`showOtherOption(enabled)`	`CheckboxItem`	Menetapkan apakah item memiliki opsi "quot;other".

Dokumentasi mendetail

`clearValidation()`

Menghapus validasi data untuk item kotak centang ini.

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createChoice(value)`

Membuat pilihan baru.

Parameter

Name	Jenis	Deskripsi
`value`	`String`	nilai pilihan yang akan dilihat responden sebagai label saat melihat formulir

Return

Choice — pilihan baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createChoice(value, isCorrect)`

Membuat pilihan baru.

Parameter

Name	Jenis	Deskripsi
`value`	`String`	nilai pilihan yang akan dilihat responden sebagai label saat melihat formulir
`isCorrect`	`Boolean`	apakah pilihan tersebut adalah jawaban yang benar

Return

Choice — pilihan baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createResponse(responses)`

Membuat ItemResponse baru untuk item kotak centang ini. Argumen responses adalah array String[] yang berisi nilai yang perlu diperiksa. Melempar pengecualian jika ada nilai yang tidak cocok dengan pilihan yang valid untuk item ini, kecuali showOtherOption(enabled) ditetapkan ke true.

Parameter

Name	Jenis	Deskripsi
`responses`	`String[]`	array jawaban yang valid untuk item pilihan ganda ini

Return

ItemResponse — respons item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`duplicate()`

Membuat salinan item ini dan menambahkannya ke akhir formulir.

Return

CheckboxItem — duplikat dari CheckboxItem ini, untuk perantaian

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getChoices()`

Mendapatkan semua pilihan untuk sebuah item.

Return

Choice[] — array pilihan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFeedbackForCorrect()`

Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.

Return

QuizFeedback — masukan, jika ada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFeedbackForIncorrect()`

Menampilkan masukan yang ditampilkan kepada responden jika mereka salah menjawab pertanyaan.

Return

QuizFeedback — masukan, jika ada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getHelpText()`

Mendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).

Return

String — teks bantuan atau teks deskripsi item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getId()`

Mendapatkan ID unik item.

Return

Integer — ID item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getIndex()`

Mendapatkan indeks item di antara semua item dalam formulir.

Return

Integer — indeks item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getPoints()`

Menampilkan nilai poin dari item yang dapat dinilai.

Return

Integer — jumlah poin nilai sebuah pertanyaan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTitle()`

Mendapatkan judul item (terkadang disebut teks header, untuk SectionHeaderItem).

Return

String — judul atau teks header item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getType()`

Mendapatkan jenis item, yang direpresentasikan sebagai ItemType.

Return

ItemType — jenis item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`hasOtherOption()`

Menentukan apakah item memiliki opsi "lainnya".

Return

Boolean — true jika item memiliki opsi "other"; false jika tidak

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isRequired()`

Menentukan apakah responden harus menjawab pertanyaan atau tidak.

Return

Boolean — apakah responden harus menjawab pertanyaan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setChoiceValues(values)`

Menetapkan pilihan untuk item dari array string. Menampilkan pengecualian jika array yang diberikan kosong.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parameter

Name	Jenis	Deskripsi
`values`	`String[]`	array nilai pilihan, yang responden lihat sebagai label saat melihat formulir

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setChoices(choices)`

Menetapkan array pilihan untuk sebuah item. Melempar pengecualian jika array yang diberikan kosong atau berisi elemen null.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parameter

Name	Jenis	Deskripsi
`choices`	`Choice[]`	array pilihan

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Menampilkan

Error — jika array yang ditentukan adalah null, kosong, atau berisi elemen null

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFeedbackForCorrect(feedback)`

Menetapkan masukan untuk ditampilkan kepada responden saat mereka menjawab pertanyaan dengan benar.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parameter

Name	Jenis	Deskripsi
`feedback`	`QuizFeedback`	masukan baru. Nilai null akan menghapus masukan.

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFeedbackForIncorrect(feedback)`

Setel masukan untuk ditampilkan kepada responden saat mereka salah menjawab pertanyaan.

Parameter

Name	Jenis	Deskripsi
`feedback`	`QuizFeedback`	masukan baru

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setHelpText(text)`

Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).

Parameter

Name	Jenis	Deskripsi
`text`	`String`	teks bantuan baru

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setPoints(points)`

Menetapkan jumlah poin untuk item yang dapat dinilai. Default untuk item baru adalah 0.

Parameter

Name	Jenis	Deskripsi
`points`	`Integer`	jumlah poin nilai item pertanyaan

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setRequired(enabled)`

Menetapkan apakah responden harus menjawab pertanyaan.

Parameter

Name	Jenis	Deskripsi
`enabled`	`Boolean`	apakah responden harus menjawab pertanyaan

Return

CheckboxItem — item saat ini (untuk rantai)

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTitle(title)`

Menetapkan judul item (terkadang disebut teks header, untuk SectionHeaderItem).

Parameter

Name	Jenis	Deskripsi
`title`	`String`	judul atau teks header baru

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setValidation(validation)`

Menetapkan validasi data untuk item kotak centang ini. Meneruskan null atau validasi tanpa fungsi yang dipanggil akan memanggil validasi sebelumnya.

Parameter

Name	Jenis	Deskripsi
`validation`	`CheckboxValidation`	sebuah CheckboxValidation untuk diterapkan ke item ini.

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`showOtherOption(enabled)`

Menetapkan apakah item memiliki opsi "quot;other". Default untuk CheckboxItem atau MultipleChoiceItem baru adalah false.

Parameter

Name	Jenis	Deskripsi
`enabled`	`Boolean`	`true` jika item memiliki opsi "lainnya" `false` jika tidak

Return

CheckboxItem — ini CheckboxItem, untuk rantai

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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