Class CheckboxGridItem

Onay kutusuIzgaraÖğe

Sütun ve satırlardan oluşan bir ızgara olarak sunulan ve katılımcının bir onay kutusu dizisinden satır başına birden fazla seçenek belirlemesine olanak tanıyan bir soru öğesi. Öğelere Form üzerinden erişilebilir veya öğeler Form üzerinden oluşturulabilir. 

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
    .setRows(['New York', 'San Francisco', 'London'])
    .setColumns(['2014', '2015', '2016', '2017']);

Yöntemler

YöntemDönüş türüKısa açıklama
clearValidation()CheckboxGridItemBu ızgara öğesinin tüm veri doğrulamalarını kaldırır.
createResponse(responses)ItemResponseBu onay kutusu ızgara öğesi için yeni bir ItemResponse oluşturur.
duplicate()CheckboxGridItemBu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
getColumns()String[]Izgaradaki her sütunun değerlerini alır.
getHelpText()StringÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır.
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasında öğenin dizin numarasını alır.
getRows()String[]Izgaradaki her satırın değerlerini alır.
getTitle()StringÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) alır.
getType()ItemTypeÖğenin türünü ItemType olarak temsil eder.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setColumns(columns)CheckboxGridItemIzgaranın sütunlarını bir değer dizisine göre ayarlar.
setHelpText(text)CheckboxGridItemÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.
setRequired(enabled)CheckboxGridItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setRows(rows)CheckboxGridItemIzgara satırlarını bir değer dizisine göre ayarlar.
setTitle(title)CheckboxGridItemÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.
setValidation(validation)CheckboxGridItemBu onay kutusu ızgara öğesinin veri doğrulamasını ayarlar.

Ayrıntılı dokümanlar

clearValidation()

Bu ızgara öğesinin tüm veri doğrulamalarını kaldırır.

Return

CheckboxGridItem: zincirleme için bu öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createResponse(responses)

Bu onay kutusu ızgara öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni, onay kutusu ızgarasındaki giriş sayısı kadar değer içeren bir String[][] dizi dizisi olmalıdır. Zorunlu olmayan bir onay kutulu tablo sorusu için null öğesi, söz konusu satır için yanıt olmadığını gösterir. Değerlerden herhangi biri geçerli bir seçimle eşleşmezse istisna oluşturur.

Parametreler

AdTürAçıklama
responsesString[][]Bu onay kutusu tablosu öğesi için geçerli yanıtlardan oluşan bir dizi dizisi

Return

ItemResponse: Öğe yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

duplicate()

Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler.

Return

CheckboxGridItem: zincirleme için bu CheckboxGridItem öğesinin kopyası

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getColumns()

Izgaradaki her sütunun değerlerini alır.

Return

String[]: Katılımcıların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHelpText()

Öğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır.

Return

String: Öğenin yardım metni veya açıklama metni

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getId()

Öğenin benzersiz tanımlayıcısını alır.

Return

Integer: Öğenin kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getIndex()

Formdaki tüm öğeler arasında öğenin dizin numarasını alır.

Return

Integer: Öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRows()

Izgaradaki her satırın değerlerini alır.

Return

String[]: Katılımcıların formu görüntülerken etiket olarak gördüğü bir satır değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTitle()

Öğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) alır.

Return

String: Öğenin başlığı veya başlık metni

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getType()

Öğenin türünü ItemType olarak temsil eder.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isRequired()

Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.

Return

Boolean: Katılımcının soruyu yanıtlaması gerekip gerekmediği

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setColumns(columns)

Izgaranın sütunlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa istisna oluşturur.

Parametreler

AdTürAçıklama
columnsString[]Katılımcıların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Return

CheckboxGridItem: zincirleme için bu öğe

Atışlar

Error: Belirtilen dizi null ise veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setHelpText(text)

Öğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

CheckboxGridItem: Zincirleme için bu CheckboxGridItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setRequired(enabled)

Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.

Parametreler

AdTürAçıklama
enabledBooleanKatılımcının soruyu yanıtlaması gerekip gerekmediği

Return

CheckboxGridItem: Geçerli öğe (zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setRows(rows)

Izgara satırlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa istisna oluşturur.

Parametreler

AdTürAçıklama
rowsString[]Katılımcıların formu görüntülerken etiket olarak gördüğü bir satır değerleri dizisi

Return

CheckboxGridItem: zincirleme için bu öğe

Atışlar

Error: Belirtilen dizi null ise veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTitle(title)

Öğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
titleStringyeni başlık veya başlık metni

Return

CheckboxGridItem: Zincirleme için bu CheckboxGridItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setValidation(validation)

Bu onay kutusu ızgara öğesinin veri doğrulamasını ayarlar. Gerekli işlevler çağrılmadan null veya doğrulama geçirilirse önceki doğrulamalar kaldırılır.

Parametreler

AdTürAçıklama
validationCheckboxGridValidationBu öğeye uygulanacak bir CheckboxGridValidation.

Return

CheckboxGridItem: Zincirleme için bu CheckboxGridItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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