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 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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
clearValidation() | CheckboxGridItem | Bu tablo öğesi için veri doğrulamasını kaldırır. |
createResponse(responses) | ItemResponse | Bu onay kutusu tablo öğesi için yeni bir ItemResponse oluşturur. |
duplicate() | CheckboxGridItem | Bu öğ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() | Integer | Formdaki 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() | Boolean | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setColumns(columns) | CheckboxGridItem | Izgaranı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) | CheckboxGridItem | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
setRows(rows) | CheckboxGridItem | Izgaranı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) | CheckboxGridItem | Bu 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
Ad | Tür | Açıklama |
---|---|---|
responses | String[][] | 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()
Tablodaki 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
Ad | Tür | Açıklama |
---|---|---|
columns | String[] | 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
Ad | Tür | Açıklama |
---|---|---|
text | String | yeni 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
Ad | Tür | Açıklama |
---|---|---|
enabled | Boolean | katı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
Ad | Tür | Açıklama |
---|---|---|
rows | String[] | 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
Ad | Tür | Açıklama |
---|---|---|
title | String | yeni 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
Ad | Tür | Açıklama |
---|---|---|
validation | CheckboxGridValidation | Bu öğ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