Diese Seite wurde von der Cloud Translation API übersetzt.

Class GridItem

Ein Frageelement, das als Raster aus Spalten und Zeilen dargestellt wird und bei dem die Befragten aus einer Reihe von Optionsfeldern eine Auswahl pro Zeile treffen können. Auf Elemente kann über eine Form zugegriffen oder sie können dort erstellt werden.

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 die Datenvalidierung für dieses Rasterelement.
`createResponse(responses)`	`ItemResponse`	Erstellt eine neue `ItemResponse` für dieses Rasterelement.
`duplicate()`	`GridItem`	Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
`getColumns()`	`String[]`	Hiermit werden die Werte für jede Spalte im Raster abgerufen.
`getHelpText()`	`String`	Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`getId()`	`Integer`	Die eindeutige Kennung des Artikels.
`getIndex()`	`Integer`	Ruft den Index des Elements unter allen Elementen im Formular ab.
`getRows()`	`String[]`	Hiermit werden die Werte für jede Zeile im Raster abgerufen.
`getTitle()`	`String`	Der Titel des Artikels (im Fall einer `SectionHeaderItem` auch als Headertext bezeichnet).
`getType()`	`ItemType`	Der Typ des Artikels, dargestellt als `ItemType`.
`isRequired()`	`Boolean`	Bestimmt, ob die Befragten die Frage beantworten müssen.
`setColumns(columns)`	`GridItem`	Legt die Spalten des Rasters anhand eines Arrays von Werten fest.
`setHelpText(text)`	`GridItem`	Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` auch als Beschreibungstext bezeichnet).
`setRequired(enabled)`	`GridItem`	Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.
`setRows(rows)`	`GridItem`	Legt die Zeilen des Rasters anhand eines Wertearrays fest.
`setTitle(title)`	`GridItem`	Hiermit wird der Titel des Artikels festgelegt (im Fall eines `SectionHeaderItem` auch als Headertext bezeichnet).
`setValidation(validation)`	`GridItem`	Legt die Datenvalidierung für dieses Rasterelement fest.

Detaillierte Dokumentation

`clearValidation()`

Entfernt die Datenvalidierung für dieses Rasterelement.

Rückflug

GridItem – dieses Element, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 mit so vielen Werten wie die Anzahl der Zeilen im Raster sein. Ein null-Element für eine nicht erforderliche Rasterfrage gibt an, dass für diese Zeile keine Antwort gegeben wurde. Löst eine Ausnahme aus, wenn einer der Werte nicht zu einer gültigen Auswahl passt.

Parameter

Name	Typ	Beschreibung
`responses`	`String[]`	eine Reihe gültiger Antworten für dieses Rasterelement

Rückflug

ItemResponse – die Artikelantwort

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`duplicate()`

Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.

Rückflug

GridItem – Duplikat dieses GridItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getColumns()`

Hiermit werden die Werte für jede Spalte im Raster abgerufen.

Rückflug

String[]: ein Array von Spaltenwerten, die den Teilnehmern im Formular als Labels angezeigt werden

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getHelpText()`

Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Rückflug

String: Hilfetext oder Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getId()`

Die eindeutige Kennung des Artikels.

Rückflug

Integer: die Artikel-ID

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getIndex()`

Ruft den Index des Elements unter allen Elementen im Formular ab.

Rückflug

Integer: der Index des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getRows()`

Hiermit werden die Werte für jede Zeile im Raster abgerufen.

Rückflug

String[]: ein Array von Zeilenwerten, die den Teilnehmern im Formular als Labels angezeigt werden

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getTitle()`

Der Titel des Artikels (im Fall einer SectionHeaderItem auch als Headertext bezeichnet).

Rückflug

String – Titel oder Headertext des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

Der Typ des Artikels, dargestellt als ItemType.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isRequired()`

Bestimmt, ob die Befragten die Frage beantworten müssen.

Rückflug

Boolean – ob die Befragten die Frage beantworten müssen

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setColumns(columns)`

Legt die Spalten des Rasters anhand 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 den Teilnehmern im Formular als Labels angezeigt werden

Rückflug

GridItem – dieses Element, zur Verkettung

Löst aus

Error – wenn das angegebene Array null oder leer ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setHelpText(text)`

Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).

Parameter

Name	Typ	Beschreibung
`text`	`String`	den neuen Hilfetext

Rückflug

GridItem – dieses GridItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRequired(enabled)`

Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	ob die Befragten die Frage beantworten müssen

Rückflug

GridItem – das aktuelle Element (für die Verkettung)

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRows(rows)`

Legt die Zeilen des Rasters anhand eines Wertearrays 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 im Formular als Labels angezeigt werden

Rückflug

GridItem – dieses Element, zur Verkettung

Löst aus

Error – wenn das angegebene Array null oder leer ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setTitle(title)`

Hiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Parameter

Name	Typ	Beschreibung
`title`	`String`	den neuen Titel oder Headertext

Rückflug

GridItem – dieses GridItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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 ohne Aufrufe von „require“-Funktionen übergeben, wird jede vorherige Validierung entfernt.

Parameter

Name	Typ	Beschreibung
`validation`	`GridValidation`	eine GridValidation, die auf dieses Element angewendet werden soll.

Rückflug

GridItem – dieses GridItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms