Class CheckboxGridItem

CheckboxGridItem

Soru öğesi; yanıt verenin bir dizi onay kutusu arasından satır başına birden çok seçenek belirlemesini sağlayan, sütunlardan ve satırlardan oluşan bir ızgara şeklinde sunulur. Öğelere Form aracılığıyla erişilebilir veya öğe oluşturulabilir.

// Open a form by ID and add a new checkgox 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 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 bunu formun sonuna ekler.
getColumns()String[]Tablodaki her sütunun değerlerini alır.
getHelpText()StringÖğenin yardım metnini alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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ında öğenin dizinini alır.
getRows()String[]Tablodaki her satır için değerleri alır.
getTitle()StringÖğenin başlığını alır (SectionHeaderItem durumunda başlık metni de denir).
getType()ItemTypeÖğenin türünü alır (ItemType ile gösterilir).
isRequired()BooleanKatılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
setColumns(columns)CheckboxGridItemIzgara 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 cevaplaması 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 durumunda başlık metni de denir).
setValidation(validation)CheckboxGridItemBu onay kutusu ızgara öğesi için veri doğrulamasını ayarlar.

Ayrıntılı belgeler

clearValidation()

Bu tablo öğesi için tüm veri doğrulamalarını kaldırır.

Return

CheckboxGridItem — bu öğe (Zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 ızgara öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni, onay kutusu tablosundaki giriş sayısı kadar değer içeren String[][] dizi dizisi olmalıdır. Zorunlu olmayan bir onay kutusu ızgara sorusu için null öğesi, bu satıra yanıt verilmediğini gösterir. Değerlerden herhangi biri geçerli bir seçimle eşleşmiyorsa istisna oluşturur.

Parametreler

AdTürAçıklama
responsesString[][]bu onay kutusu ızgara öğesi için geçerli yanıt dizileri dizisi

Return

ItemResponse: Öğe yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bunu formun sonuna ekler.

Return

CheckboxGridItem — zincirleme bağlantı için bu CheckboxGridItem öğesinin kopyası

Yetkilendirme

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

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

getColumns()

Tablodaki 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 kapsamların 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 alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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 kapsamların 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 kapsamların 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRows()

Tablodaki her satır için değerleri alır.

Return

String[] - Katılımcıları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 kapsamların 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 (SectionHeaderItem durumunda başlık metni de denir).

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ü alır (ItemType ile gösterilir).

Return

ItemType - öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setColumns(columns)

Izgara sütunlarını bir değer dizisine göre ayarlar. Belirtilen dizi boşsa bir 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 — bu öğe (Zincirleme için)

Dekoratif yastıklar

Error - belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (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 — bu CheckboxGridItem, zincirleme bağlantı için

Yetkilendirme

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

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bir istisna atar.

Parametreler

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

Return

CheckboxGridItem — bu öğe (Zincirleme için)

Dekoratif yastıklar

Error - belirtilen dizi null veya boşsa

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem durumunda başlık metni de denir).

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 kapsamların 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 ızgara öğesi için veri doğrulamasını ayarlar. Herhangi bir zorunlu işlev çağrılmadığı sürece null değerinin veya doğrulamanın iletilmesi, önceki doğrulamaları kaldırır.

Parametreler

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

Return

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

Yetkilendirme

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

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