Halaman ini diterjemahkan oleh Cloud Translation API.

Class CheckboxGridItem

Item pertanyaan, dibacakan sebagai petak kolom dan baris, yang memungkinkan responden memilih beberapa pilihan per baris dari urutan kotak centang. Item dapat diakses atau dibuat dari Form.

// Open a form by ID and add a new checkbox 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']);

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`clearValidation()`	`CheckboxGridItem`	Menghapus validasi data untuk item petak ini.
`createResponse(responses)`	`ItemResponse`	Membuat `ItemResponse` baru untuk item petak kotak centang ini.
`duplicate()`	`CheckboxGridItem`	Membuat salinan item ini dan menambahkannya ke bagian akhir formulir.
`getColumns()`	`String[]`	Mendapatkan nilai untuk setiap kolom dalam grid.
`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.
`getRows()`	`String[]`	Mendapatkan nilai untuk setiap baris dalam petak.
`getTitle()`	`String`	Mendapatkan judul item (terkadang disebut teks header, dalam kasus `SectionHeaderItem`).
`getType()`	`ItemType`	Mendapatkan jenis item, yang direpresentasikan sebagai `ItemType`.
`isRequired()`	`Boolean`	Menentukan apakah responden harus menjawab pertanyaan.
`setColumns(columns)`	`CheckboxGridItem`	Menetapkan kolom petak berdasarkan array nilai.
`setHelpText(text)`	`CheckboxGridItem`	Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti `ImageItems`, `PageBreakItems`, dan `SectionHeaderItems`).
`setRequired(enabled)`	`CheckboxGridItem`	Menetapkan apakah responden harus menjawab pertanyaan.
`setRows(rows)`	`CheckboxGridItem`	Menetapkan baris petak berdasarkan array nilai.
`setTitle(title)`	`CheckboxGridItem`	Menetapkan judul item (terkadang disebut teks header, dalam kasus `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxGridItem`	Menetapkan validasi data untuk item petak kotak centang ini.

Dokumentasi mendetail

`clearValidation()`

Menghapus validasi data untuk item petak ini.

Pulang pergi

CheckboxGridItem — item 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

`createResponse(responses)`

Membuat ItemResponse baru untuk item petak kotak centang ini. Argumen responses harus berupa array String[][] yang berisi nilai sebanyak jumlah input di kisi kotak centang. Elemen null untuk pertanyaan petak kotak centang yang tidak diperlukan menunjukkan tidak ada respons terhadap baris tersebut. Menampilkan pengecualian jika salah satu nilai tidak cocok dengan pilihan yang valid.

Parameter

Nama	Jenis	Deskripsi
`responses`	`String[][]`	array jawaban yang valid untuk item petak kotak centang ini

Pulang pergi

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 bagian akhir formulir.

Pulang pergi

CheckboxGridItem — duplikat dari CheckboxGridItem 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

`getColumns()`

Mendapatkan nilai untuk setiap kolom dalam grid.

Pulang pergi

String[] — array nilai kolom, yang dilihat responden sebagai label saat melihat formulir

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

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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

`getRows()`

Mendapatkan nilai untuk setiap baris dalam petak.

Pulang pergi

String[] — array nilai baris, yang dilihat responden sebagai label saat melihat formulir

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, dalam kasus SectionHeaderItem).

Pulang pergi

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.

Pulang pergi

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

`isRequired()`

Menentukan apakah responden harus menjawab pertanyaan.

Pulang pergi

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

`setColumns(columns)`

Menetapkan kolom petak berdasarkan array nilai. Menampilkan pengecualian jika yang diberikan array kosong.

Parameter

Nama	Jenis	Deskripsi
`columns`	`String[]`	array nilai kolom, yang dilihat responden sebagai label saat melihat formulir

Pulang pergi

CheckboxGridItem — item ini, untuk perantaian

Menampilkan

Error — jika array yang diberikan adalah null atau kosong

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

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

Pulang pergi

CheckboxGridItem — CheckboxGridItem ini, untuk perantai

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

Nama	Jenis	Deskripsi
`enabled`	`Boolean`	apakah responden harus menjawab pertanyaan atau tidak

Pulang pergi

CheckboxGridItem — item saat 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

`setRows(rows)`

Menetapkan baris petak berdasarkan array nilai. Menampilkan pengecualian jika array yang diberikan kosong.

Parameter

Nama	Jenis	Deskripsi
`rows`	`String[]`	array nilai baris, yang dilihat responden sebagai label saat melihat formulir

Pulang pergi

CheckboxGridItem — item ini, untuk perantaian

Menampilkan

Error — jika array yang diberikan adalah null atau kosong

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, dalam kasus SectionHeaderItem).

Parameter

Nama	Jenis	Deskripsi
`title`	`String`	judul atau teks {i>header <i}baru

Pulang pergi

CheckboxGridItem — CheckboxGridItem ini, untuk perantai

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 petak kotak centang ini. Meneruskan {i>null <i}atau validasi tanpa fungsi wajib yang dipanggil akan menghapus validasi sebelumnya.

Parameter

Nama	Jenis	Deskripsi
`validation`	`CheckboxGridValidation`	CheckboxGridValidation untuk diterapkan ke item ini.

Pulang pergi

CheckboxGridItem — CheckboxGridItem ini, untuk perantai

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