Ein Frageelement, das als Raster aus Spalten und Zeilen dargestellt wird und es dem Teilnehmer ermöglicht, aus einer Reihe von Kästchen mehrere Auswahlmöglichkeiten pro Zeile auszuwählen. Elemente können über eine 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 -Element für dieses Kästchen-Rasterelement. |
duplicate() | CheckboxGridItem | Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an. |
getColumns() | String[] | Ruft die Werte für jede Spalte im Raster ab. |
getHelpText() | String | den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet) |
getId() | Integer | Ruft die eindeutige ID des Artikels 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 (im Fall eines SectionHeaderItem -Elements manchmal auch als Überschrifttext bezeichnet). |
getType() | ItemType | Ruft den Typ des Elements ab, dargestellt als ItemType . |
isRequired() | Boolean | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setColumns(columns) | CheckboxGridItem | Legt die Spalten des Rasters auf der Grundlage eines Arrays von Werten fest. |
setHelpText(text) | CheckboxGridItem | Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems , PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet. |
setRequired(enabled) | CheckboxGridItem | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setRows(rows) | CheckboxGridItem | Legt die Zeilen des Rasters auf der Grundlage eines Arrays von Werten fest. |
setTitle(title) | CheckboxGridItem | Legt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet. |
setValidation(validation) | CheckboxGridItem | Legt die Datenvalidierung für dieses Kästchen-Rasterelement fest. |
Detaillierte Dokumentation
clearValidation()
Entfernt alle Datenvalidierungen für dieses Rasterelement.
Return
CheckboxGridItem
: dieses Element für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Erstellt ein neues ItemResponse
-Element für dieses Kästchen-Rasterelement. Das Argument responses
muss ein String[][]
-Array von 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 auf diese Zeile keine Antwort gegeben wird. Löst eine Ausnahme aus, wenn einer der Werte mit keiner gültigen Auswahl übereinstimmt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
responses | String[][] | Array mit gültigen Antworten für dieses Kästchen-Rasterelement |
Return
ItemResponse
: die Elementantwort
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.
Return
CheckboxGridItem
– ein Duplikat dieses CheckboxGridItem
für die Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Ruft die Werte für jede Spalte im Raster ab.
Return
String[]
: ein Array von Spaltenwerten, die die Befragten beim Aufrufen des Formulars als Labels sehen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet)
Return
String
: Hilfe- oder Beschreibungstext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige ID des Artikels ab.
Return
Integer
: ID des Artikels
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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.
Return
Integer
: der Index des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Ruft die Werte für jede Zeile im Raster ab.
Return
String[]
: ein Array von Zeilenwerten, die die Befragten beim Aufrufen des Formulars als Labels sehen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab (im Fall eines SectionHeaderItem
-Elements manchmal auch als Überschrifttext bezeichnet).
Return
String
: Titel oder Überschriftentext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Typ des Elements ab, dargestellt als ItemType
.
Return
ItemType
: Typ des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Return
Boolean
: Gibt an, ob der Teilnehmer die Frage beantworten muss
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Legt die Spalten des Rasters auf der Grundlage eines Arrays von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columns | String[] | Ein Array von Spaltenwerten, die Befragten beim Aufrufen des Formulars als Beschriftungen angezeigt werden |
Return
CheckboxGridItem
: dieses Element für Verkettung
Löst aus
Error
– wenn das angegebene Array null
oder leer ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems
, PageBreakItems
und SectionHeaderItems
wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | dem neuen Hilfetext |
Return
CheckboxGridItem
– dieses CheckboxGridItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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 Befragte die Frage beantworten muss |
Return
CheckboxGridItem
: das aktuelle Element (zur Verkettung)
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Legt die Zeilen des Rasters auf der Grundlage 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 Umfrageteilnehmern beim Aufrufen des Formulars als Labels angezeigt werden |
Return
CheckboxGridItem
: dieses Element für Verkettung
Löst aus
Error
– wenn das angegebene Array null
oder leer ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest. Bei SectionHeaderItem
wird dieser Text manchmal auch als Überschrifttext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | dem neuen Titel oder Text der Überschrift |
Return
CheckboxGridItem
– dieses CheckboxGridItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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 null oder eine Validierung ohne aufgerufene erforderliche Funktionen übergeben wird, wird jede vorherige Validierung entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
validation | CheckboxGridValidation | eine CheckboxGridValidation, die auf dieses Element angewendet werden soll. |
Return
CheckboxGridItem
– dieses CheckboxGridItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms