Class GridItem

GridItem

Ein Frageelement, das als Raster aus Spalten und Zeilen dargestellt wird und es dem Befragten ermöglicht, eine Auswahl pro Zeile aus einer Reihe von Optionsfeldern auszuwählen. Elemente können über eine 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 ein neues ItemResponse-Element für dieses Rasterelement.
duplicate()GridItemErstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.
getColumns()String[]Ruft die Werte für jede Spalte im Raster ab.
getHelpText()Stringden Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet)
getId()IntegerRuft die eindeutige ID des Artikels 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 (im Fall eines SectionHeaderItem-Elements manchmal auch als Überschrifttext bezeichnet).
getType()ItemTypeRuft den Typ des Elements ab, dargestellt als ItemType.
isRequired()BooleanLegt fest, ob der Teilnehmer die Frage beantworten muss.
setColumns(columns)GridItemLegt die Spalten des Rasters auf der Grundlage eines Arrays von Werten fest.
setHelpText(text)GridItemLegt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
setRequired(enabled)GridItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setRows(rows)GridItemLegt die Zeilen des Rasters auf der Grundlage eines Arrays von Werten fest.
setTitle(title)GridItemLegt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet.
setValidation(validation)GridItemLegt die Datenvalidierung für dieses Rasterelement fest.

Detaillierte Dokumentation

clearValidation()

Entfernt alle Datenvalidierungen für dieses Rasterelement.

Return

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

createResponse(responses)

Erstellt ein neues ItemResponse-Element 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 bedeutet, dass auf diese Zeile keine Antwort gegeben wird. Löst eine Ausnahme aus, wenn einer der Werte mit keiner gültigen Auswahl übereinstimmt.

Parameter

NameTypBeschreibung
responsesString[]Array gültiger Antworten für dieses Rasterelement

Return

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

Return

GridItem – ein Duplikat dieses GridItem für die 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.

Return

String[]: ein Array von Spaltenwerten, die die Befragten beim Aufrufen des Formulars als Labels sehen

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

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

Return

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

Return

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

Return

Integer: der 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.

Return

String[]: ein Array von Zeilenwerten, die die Befragten beim Aufrufen des Formulars als Labels sehen

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 (im Fall eines SectionHeaderItem-Elements manchmal auch als Überschrifttext bezeichnet).

Return

String: Titel oder Überschriftentext 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.

Return

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

Legt fest, ob der Teilnehmer die Frage beantworten muss.

Return

Boolean: Gibt an, 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 auf der Grundlage eines Arrays von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.

Parameter

NameTypBeschreibung
columnsString[]Ein Array von Spaltenwerten, die Befragten beim Aufrufen des Formulars als Beschriftungen angezeigt werden

Return

GridItem: dieses Element für 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. Bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet.

Parameter

NameTypBeschreibung
textStringdem neuen Hilfetext

Return

GridItem – dieses 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 Teilnehmer die Frage beantworten muss.

Parameter

NameTypBeschreibung
enabledBooleanob der Befragte die Frage beantworten muss

Return

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

setRows(rows)

Legt die Zeilen des Rasters auf der Grundlage eines Arrays von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.

Parameter

NameTypBeschreibung
rowsString[]Ein Array von Zeilenwerten, die Umfrageteilnehmern beim Aufrufen des Formulars als Labels angezeigt werden

Return

GridItem: dieses Element für 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. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet.

Parameter

NameTypBeschreibung
titleStringdem neuen Titel oder Text der Überschrift

Return

GridItem – dieses 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. Wenn null oder eine Validierung ohne aufgerufene Anforderungsfunktionen übergeben wird, wird jede vorherige Validierung entfernt.

Parameter

NameTypBeschreibung
validationGridValidationeine GridValidation, die auf dieses Element angewendet werden soll.

Return

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