Class CheckboxGridItem

CheckboxGridItem

Yanıtlayanın bir dizi onay kutusundan satır başına birden fazla seçenek belirlemesine olanak tanıyan, sütun ve satır ızgarası olarak sunulan bir soru öğesi. Öğelere Form üzerinden erişilebilir veya bu platformda öğe 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 öğesiyle ilgili tüm veri doğrulamayı kaldırır.
createResponse(responses)ItemResponseBu onay kutusu ızgarası öğ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 (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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 dizinini alır.
getRows()String[]Izgaradaki her satırın değerlerini alır.
getTitle()StringÖğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).
getType()ItemTypeÖğenin türünü ItemType olarak alır.
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 (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.
setRequired(enabled)CheckboxGridItemKatılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setRows(rows)CheckboxGridItemIzgaranın satırlarını bir değer dizisine göre ayarlar.
setTitle(title)CheckboxGridItemÖğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).
setValidation(validation)CheckboxGridItemBu onay kutusu ızgarası öğesi için veri doğrulama ayarlar.

Ayrıntılı belgeler

clearValidation()

Bu ızgara öğesiyle ilgili tüm veri doğrulamayı kaldırır.

Return

CheckboxGridItem: Zincirleme için bu öğe

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

createResponse(responses)

Bu onay kutusu ızgarası öğ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[][] dizisi olmalıdır. Gerekli olmayan bir onay kutulu tablo sorusu için null öğesi, ilgili satıra yanıt verilmediğini gösterir. Değerlerden herhangi biri geçerli bir seçenekle eşleşmezse istisna oluşturur.

Parametreler

AdTürAçıklama
responsesString[][]Bu onay kutulu tablo öğesi için geçerli yanıt dizileri dizisi

Return

ItemResponse: Öğenin yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getColumns()

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

Return

String[]: Yanıtlayanların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getHelpText()

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getIndex()

Formdaki tüm öğeler arasında öğenin dizinini alır.

Return

Integer: Öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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[]: Yanıtlayanların formu görüntülerken etiket olarak gördüğü satır değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTitle()

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getType()

Öğenin türünü ItemType olarak alır.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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[]Yanıtlayanların formu görüntülerken etiket olarak gördüğü sütun değerleri dizisi

Return

CheckboxGridItem: Zincirleme için bu öğe

Verdiği hatalar

Error: Belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setHelpText(text)

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setRequired(enabled)

Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setRows(rows)

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

Parametreler

AdTürAçıklama
rowsString[]Yanıtlayanların formu görüntülerken etiket olarak gördüğü satır değerleri dizisi

Return

CheckboxGridItem: Zincirleme için bu öğe

Verdiği hatalar

Error: Belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setTitle(title)

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

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setValidation(validation)

Bu onay kutusu ızgarası öğesi için veri doğrulama ayarlar. Boş değer veya herhangi bir zorunlu işlev çağrılmadan yapılan doğrulama iletildiğinde önceki tüm 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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