Class CheckboxGridItem

CheckboxGridItem

Katılımcının seçmesine olanak tanıyan, sütunlardan ve satırlardan oluşan bir tablo olarak sunulan soru öğesi birden çok seçeneği işaretleyebilirsiniz. Öğelere şuradan erişebilir veya öğe oluşturabilirsiniz: 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']);

Yöntemler

YöntemDönüş türüKısa açıklama
clearValidation()CheckboxGridItemBu tablo öğesi için veri doğrulamasını kaldırır.
createResponse(responses)ItemResponseBu onay kutusu tablo öğ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 alır (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır).
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasından öğenin dizinini alır.
getRows()String[]Izgaradaki her satırın değerlerini alır.
getTitle()StringÖğenin başlığını alır (SectionHeaderItem olması halinde bazen üstbilgi metni olarak da adlandırılır).
getType()ItemTypeÖğenin ItemType ile gösterilen türünü alır.
isRequired()BooleanKatılımcının soruyu cevaplaması 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 ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).
setRequired(enabled)CheckboxGridItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setRows(rows)CheckboxGridItemIzgaranın satırlarını bir değer dizisine göre ayarlar.
setTitle(title)CheckboxGridItemÖğenin başlığını ayarlar (SectionHeaderItem özelliğinde bazen başlık metni olarak da adlandırılır).
setValidation(validation)CheckboxGridItemBu onay kutusu tablo öğesi için veri doğrulamasını ayarlar.

Ayrıntılı belgeler

clearValidation()

Bu tablo öğesi için veri doğrulamasını kaldırır.

Return

CheckboxGridItem — bu öğe, zincirleme kullanım için

Yetkilendirme

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

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

createResponse(responses)

Bu onay kutusu tablo öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni giriş sayısı kadar değer içeren String[][] dizi dizisi olmalıdır "Tamam" düğmesini tıklayın. Zorunlu olmayan bir onay kutusu ızgara 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çimdir.

Parametreler

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

Return

ItemResponse - öğe yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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[]: Katılımcıların formu görüntülerken etiket olarak gördüğü bir sütun değerleri dizisi

Yetkilendirme

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

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

getHelpText()

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

Return

String — öğenin yardım metni veya açıklama metni

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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ından öğenin dizinini alır.

Return

Integer — öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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[] - Katılımcıların formu görüntülerken etiketler olarak gördüğü satır değerleri dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 (SectionHeaderItem olması halinde bazen üstbilgi metni olarak da 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getType()

Öğenin ItemType ile gösterilen türünü alır.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 cevaplaması 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 bir 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. Verilen dizi boş.

Parametreler

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

Return

CheckboxGridItem — bu öğe, zincirleme kullanım için

Fırlatma

Error: Belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

CheckboxGridItem — bu CheckboxGridItem, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ı gerekip gerekmediğini belirler.

Parametreler

AdTürAçıklama
enabledBooleankatılımcının soruyu cevaplaması gerekip gerekmediğini

Return

CheckboxGridItem — geçerli öğe (zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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. Verilen diziyse bir istisna atar boştur.

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 — bu öğe, zincirleme kullanım için

Fırlatma

Error: Belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 (SectionHeaderItem özelliğinde bazen başlık metni olarak da adlandırılır).

Parametreler

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

Return

CheckboxGridItem — bu CheckboxGridItem, zincirleme bağlantı için

Yetkilendirme

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

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

setValidation(validation)

Bu onay kutusu tablo öğesi için veri doğrulamasını ayarlar. Boş veya geçersiz bir doğrulama çağrıldığında, önceki doğrulamalar kaldırılır.

Parametreler

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

Return

CheckboxGridItem — bu CheckboxGridItem, zincirleme bağlantı için

Yetkilendirme

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

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