Diese Seite wurde von der Cloud Translation API übersetzt.

Class CheckboxGridItem

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