Ein Frageelement, das als Raster von Spalten und Zeilen angezeigt wird und der Teilnehmer mehrere Möglichkeiten pro Zeile aus einer Reihe von Kästchen auswählen kann. Elemente können über ein Form
aufgerufen oder erstellt werden.
// 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']);
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
clearValidation() | CheckboxGridItem | Entfernt alle Datenvalidierungen für dieses Rasterelement. |
createResponse(responses) | ItemResponse | Erstellt ein neues ItemResponse für dieses Kästchen als Rasterelement. |
duplicate() | CheckboxGridItem | Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an. |
getColumns() | String[] | Ruft die Werte für jede Spalte im Raster ab. |
getHelpText() | String | Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet. |
getId() | Integer | Ruft die eindeutige Kennung des Elements ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getRows() | String[] | Ruft die Werte für jede Zeile im Raster ab. |
getTitle() | String | Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem . |
getType() | ItemType | Ruft den Elementtyp ab, dargestellt als ItemType . |
isRequired() | Boolean | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setColumns(columns) | CheckboxGridItem | Legt die Spalten des Rasters anhand eines Wertearrays fest. |
setHelpText(text) | CheckboxGridItem | Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setRows(rows) | CheckboxGridItem | Legt die Zeilen des Rasters anhand eines Arrays von Werten fest. |
setTitle(title) | CheckboxGridItem | Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem ) |
setValidation(validation) | CheckboxGridItem | Legt die Datenvalidierung für dieses Kästchen-Rasterelement fest. |
Detaillierte Dokumentation
clearValidation()
Entfernt alle Datenvalidierungen für dieses Rasterelement.
Zurücksenden
CheckboxGridItem
: dieses Element zum Verketten
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Erstellt ein neues ItemResponse
für dieses Kästchen als Rasterelement. Das Argument responses
muss ein String[][]
-Array mit Arrays sein, die so viele Werte wie die Anzahl der Eingaben im Kästchenraster enthalten. Ein null
-Element für eine nicht erforderliche Kästchenrasterfrage gibt an, dass es keine Antwort auf diese Zeile gibt. Löst eine Ausnahme aus, wenn einer der Werte nicht mit einer gültigen Auswahl übereinstimmt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responses | String[][] | ein Array von gültigen Antworten für dieses Kästchen-Rasterelement |
Zurücksenden
ItemResponse
: die Antwort des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
Zurücksenden
CheckboxGridItem
: ein Duplikat dieses CheckboxGridItem
, für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Ruft die Werte für jede Spalte im Raster ab.
Zurücksenden
String[]
: ein Array von Spaltenwerten, die den Teilnehmern beim Ansehen des Formulars als Labels angezeigt werden
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet.
Zurücksenden
String
: der Hilfe- oder Beschreibungstext des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Zurücksenden
Integer
: die ID des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Ruft den Index des Elements aus allen Elementen im Formular ab.
Zurücksenden
Integer
: Der Index des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Ruft die Werte für jede Zeile im Raster ab.
Zurücksenden
String[]
: ein Array von Zeilenwerten, die den Teilnehmern beim Ansehen des Formulars als Labels angezeigt werden
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem
.
Zurücksenden
String
: Titel oder Titel des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Elementtyp ab, dargestellt als ItemType
.
Zurücksenden
ItemType
: Typ des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Zurücksenden
Boolean
: Gibt an, ob der Teilnehmer die Frage beantworten muss
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Legt die Spalten des Rasters anhand eines Wertearrays fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columns | String[] | ein Array von Spaltenwerten, die den Teilnehmern beim Ansehen des Formulars als Labels angezeigt werden |
Zurücksenden
CheckboxGridItem
: dieses Element zum Verketten
Throws
Error
– wenn das angegebene Array null
oder leer ist
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Zurücksenden
CheckboxGridItem
– dieser CheckboxGridItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Parameter
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | ob der Teilnehmer die Frage beantworten muss |
Zurücksenden
CheckboxGridItem
: das aktuelle Element (zum Verketten)
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Legt die Zeilen des Rasters anhand eines Arrays von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
rows | String[] | ein Array von Zeilenwerten, die den Teilnehmern beim Ansehen des Formulars als Labels angezeigt werden |
Zurücksenden
CheckboxGridItem
: dieses Element zum Verketten
Throws
Error
– wenn das angegebene Array null
oder leer ist
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem
)
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Titel |
Zurücksenden
CheckboxGridItem
– dieser CheckboxGridItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Legt die Datenvalidierung für dieses Kästchen-Rasterelement fest. Wenn Sie null oder eine Validierung übergeben, ohne dass aufgerufene Funktionen erforderlich sind, wird die vorherige Validierung entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
validation | CheckboxGridValidation | ein Kästchen, das auf dieses Element angewendet werden soll. |
Zurücksenden
CheckboxGridItem
– dieser CheckboxGridItem
für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms