Class GridItem

GridItem

Ein Frageelement, das als Raster aus Spalten und Zeilen dargestellt wird und bei dem der Teilnehmer eine Auswahl pro Zeile aus einer Reihe von Optionsfeldern treffen kann. Auf Elemente kann über eine Form zugegriffen oder sie können über eine Form 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

MethodeRückgabetypKurzbeschreibung
clearValidation()GridItemEntfernt die Datenvalidierung für dieses Rasterelement.
createResponse(responses)ItemResponseErstellt ein neues ItemResponse für dieses Rasterelement.
duplicate()GridItemErstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
getColumns()String[]Ruft die Werte für jede Spalte im Raster ab.
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getRows()String[]Ruft die Werte für jede Zeile im Raster ab.
getTitle()StringRuft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).
getType()ItemTypeRuft den Typ des Elements als ItemType ab.
isRequired()BooleanGibt an, ob der Befragte die Frage beantworten muss.
setColumns(columns)GridItemLegt die Spalten des Rasters basierend auf einem Array von Werten fest.
setHelpText(text)GridItemLegt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setRequired(enabled)GridItemLegt fest, ob der Befragte die Frage beantworten muss.
setRows(rows)GridItemLegt die Zeilen des Rasters anhand eines Wertearrays fest.
setTitle(title)GridItemLegt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).
setValidation(validation)GridItemLegt die Datenvalidierung für dieses Tabellenelement fest.

Detaillierte Dokumentation

clearValidation()

Entfernt die Datenvalidierung für dieses Rasterelement.

Rückflug

GridItem – dieses Element zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

createResponse(responses)

Erstellt ein neues ItemResponse für dieses Rasterelement. Das Argument responses muss ein String[]-Array sein, das so viele Werte enthält wie die Anzahl der Zeilen im Raster. 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 mit einer gültigen Auswahl übereinstimmt.

Parameter

NameTypBeschreibung
responsesString[]ein Array mit gültigen Antworten für dieses Rasterelement

Rückflug

ItemResponse – die Antwort auf das Element

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 – ein Duplikat dieses GridItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Teilnehmern als Labels angezeigt werden, wenn sie das Formular aufrufen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Rückflug

String – der Hilfetext oder die Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getId()

Ruft die eindeutige Kennung des Elements ab.

Rückflug

Integer: die ID des Artikels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Elements

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 als Labels angezeigt werden, wenn sie das Formular aufrufen.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTitle()

Ruft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Rückflug

String – der Titel oder Headertext des Elements

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getType()

Ruft den Typ des Elements als ItemType ab.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isRequired()

Gibt an, ob der Befragte die Frage beantworten muss.

Rückflug

Boolean – ob der Befragte die Frage beantworten muss

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 das angegebene Array leer ist.

Parameter

NameTypBeschreibung
columnsString[]ein Array von Spaltenwerten, die den Teilnehmern als Labels angezeigt werden, wenn sie das Formular aufrufen

Rückflug

GridItem – dieses Element zur Verkettung

Löst

Error – wenn das angegebene Array null oder leer ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setHelpText(text)

Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

NameTypBeschreibung
textStringder neue Hilfetext

Rückflug

GridItem – diese GridItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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

NameTypBeschreibung
enabledBooleanob der Befragte die Frage beantworten muss

Rückflug

GridItem – das aktuelle Element (zum Verketten)

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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

NameTypBeschreibung
rowsString[]Ein Array von Zeilenwerten, die den Befragten als Labels angezeigt werden, wenn sie das Formular aufrufen

Rückflug

GridItem – dieses Element zur Verkettung

Löst

Error – wenn das angegebene Array null oder leer ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTitle(title)

Legt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

GridItem – diese GridItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setValidation(validation)

Legt die Datenvalidierung für dieses Tabellenelement fest. Wenn Sie null oder eine GridValidation-Instanz übergeben, für die keine „require“-Funktionen aufgerufen wurden, wird die vorherige Validierung entfernt.

Parameter

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

Rückflug

GridItem – diese GridItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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