Class GridItem

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Rasterelement

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

MethodeRückgabetypKurzbeschreibung
clearValidation()GridItemEntfernt alle Datenvalidierungen für dieses Rasterelement.
createResponse(responses)ItemResponseErstellt eine neue ItemResponse für dieses Rasterelement.
duplicate()GridItemErstellt 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()StringRuft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements aus allen Elementen im Formular ab.
getRows()String[]Ruft die Werte für jede Zeile im Raster ab.
getTitle()StringRuft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem.
getType()ItemTypeRuft den Elementtyp ab, dargestellt als ItemType.
isRequired()BooleanLegt fest, ob der Teilnehmer die Frage beantworten muss.
setColumns(columns)GridItemLegt die Spalten des Rasters anhand eines Wertearrays fest.
setHelpText(text)GridItemLegt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).
setRequired(enabled)GridItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setRows(rows)GridItemLegt die Zeilen des Rasters anhand eines Arrays von Werten fest.
setTitle(title)GridItemLegt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)
setValidation(validation)GridItemLegt 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

NameTypBeschreibung
responsesString[]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

NameTypBeschreibung
columnsString[]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

NameTypBeschreibung
textStringden 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

NameTypBeschreibung
enabledBooleanob 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

NameTypBeschreibung
rowsString[]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

NameTypBeschreibung
titleStringden 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

NameTypBeschreibung
validationGridValidationeine „ 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