Diese Seite wurde von der Cloud Translation API übersetzt.

Class GridItem

Eine Frage, die als Raster aus Spalten und Zeilen dargestellt wird und den Befragten die Möglichkeit gibt, eine Auswahl pro Zeile über eine Reihe von Optionsfeldern. Elemente können über eine Form

// 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 sie am 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 Kennzeichnung des Artikels ab.
`getIndex()`	`Integer`	Ruft den Index des Elements unter 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. Wird manchmal als Überschrifttext bezeichnet, im Fall von `SectionHeaderItem`.
`getType()`	`ItemType`	Ruft den Typ des Elements ab, dargestellt als `ItemType`.
`isRequired()`	`Boolean`	Bestimmt, ob der Teilnehmer die Frage beantworten muss.
`setColumns(columns)`	`GridItem`	Legt die Spalten des Rasters basierend auf einem Array von Werten fest.
`setHelpText(text)`	`GridItem`	Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`setRequired(enabled)`	`GridItem`	Legt fest, ob der Befragte die Frage beantworten muss.
`setRows(rows)`	`GridItem`	Legt die Zeilen des Rasters basierend auf einem Array von Werten fest.
`setTitle(title)`	`GridItem`	Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	Legt die Datenvalidierung für dieses Rasterelement fest.

Detaillierte Dokumentation

`clearValidation()`

Entfernt alle Datenvalidierungen für dieses Rasterelement.

Rückflug

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

`createResponse(responses)`

Erstellt eine neue ItemResponse für dieses Rasterelement. Das Argument responses muss ein String[]-Array, 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 auf diese Zeile keine Antwort gegeben wird. Wirf einen Ausnahme, wenn einer der Werte mit keiner gültigen Auswahl übereinstimmt.

Parameter

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

Rückflug

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 am Ende des Formulars an.

Rückflug

GridItem – ein Duplikat von GridItem, 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

`getColumns()`

Ruft die Werte für jede Spalte im Raster ab.

Rückflug

String[]: ein Array von Spaltenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

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()`

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

Rückflug

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 Kennzeichnung des Artikels ab.

Rückflug

Integer: die 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 unter allen Elementen im Formular ab.

Rückflug

Integer – 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.

Rückflug

String[]: ein Array von Zeilenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

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. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem.

Rückflug

String: Titel oder Text der Überschrift 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.

Rückflug

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()`

Bestimmt, ob der Teilnehmer die Frage beantworten muss.

Rückflug

Boolean – 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 basierend auf einem Array von Werten fest. Löst eine Ausnahme aus, wenn die angegebene Array ist leer.

Parameter

Name	Typ	Beschreibung
`columns`	`String[]`	Eine Reihe von Spaltenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

Rückflug

GridItem – dieses Element zur 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 (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

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

Rückflug

GridItem – diese GridItem, 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 Befragte die Frage beantworten muss.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	ob der Befragte die Frage beantworten muss.

Rückflug

GridItem – das aktuelle 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

`setRows(rows)`

Legt die Zeilen des Rasters basierend auf einem Array von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array ist leer.

Parameter

Name	Typ	Beschreibung
`rows`	`String[]`	Eine Reihe von Zeilenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

Rückflug

GridItem – dieses Element zur 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 (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).

Parameter

Name	Typ	Beschreibung
`title`	`String`	den neuen Titel oder Überschriftentext

Rückflug

GridItem – diese GridItem, 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 Rasterelement fest. Die Übergabe von null oder einer Validierung ohne Mit aufgerufenen Funktionen werden alle vorherigen Validierungen entfernt.

Parameter

Name	Typ	Beschreibung
`validation`	`GridValidation`	GridValidation (GridValidation) ein, die auf dieses Element angewendet werden soll.

Rückflug

GridItem – diese GridItem, 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