Diese Seite wurde von der Cloud Translation API übersetzt.

Class GridItem

Ein Fragenelement, das als Raster von Spalten und Zeilen dargestellt wird und dem Teilnehmer die Möglichkeit hat, aus einer Reihe von Optionsfeldern eine Antwort pro Zeile auszuwählen. Elemente können über ein Form aufgerufen oder erstellt werden.

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`clearValidation()`	`GridItem`	Entfernt alle Datenvalidierungen für dieses Rasterelement.
`createResponse(responses)`	`ItemResponse`	Erstellt eine neue `ItemResponse` für dieses Rasterelement.
`duplicate()`	`GridItem`	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)`	`GridItem`	Legt die Spalten des Rasters anhand eines Wertearrays fest.
`setHelpText(text)`	`GridItem`	Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	Legt fest, ob der Teilnehmer die Frage beantworten muss.
`setRows(rows)`	`GridItem`	Legt die Zeilen des Rasters anhand eines Arrays von Werten fest.
`setTitle(title)`	`GridItem`	Legt den Titel des Elements fest (manchmal auch Headertext bei `SectionHeaderItem`)
`setValidation(validation)`	`GridItem`	Legt die Datenvalidierung für dieses Rasterelement fest.

Detaillierte Dokumentation

`clearValidation()`

Entfernt alle Datenvalidierungen für dieses Rasterelement.

Zurücksenden

GridItem: 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 eine neue ItemResponse für dieses Rasterelement. Das Argument responses muss ein String[]-Array sein, das so viele Werte wie die Anzahl der Zeilen im Raster enthält. Ein null-Element für eine nicht erforderliche Rasterfrage gibt an, dass es keine Antwort auf diese Zeile gibt. 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 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

GridItem: ein Duplikat dieses GridItem, 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

GridItem: 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

GridItem – dieser GridItem 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

GridItem: 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

GridItem: 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

GridItem – dieser GridItem 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 Rasterelement fest. Wenn Sie null oder eine Validierung übergeben, ohne dass aufgerufene Funktionen erforderlich zu sein, wird jede vorherige Validierung entfernt.

Parameter

Name	Typ	Beschreibung
`validation`	`GridValidation`	eine „ Storno“-Validierung, die auf dieses Element angewendet werden soll.

Zurücksenden

GridItem – dieser GridItem 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