Class CheckboxGridItem

CheckboxGridItem

Ein Frageelement, das als Raster von Spalten und Zeilen angezeigt wird und der Teilnehmer mehrere Möglichkeiten pro Zeile aus einer Reihe von Kästchen auswählen kann. Elemente können über ein Form aufgerufen oder erstellt werden.

// Open a form by ID and add a new checkgox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
  .setRows(['New York', 'San Francisco', 'London'])
  .setColumns(['2014', '2015', '2016', '2017']);

Methoden

MethodeRückgabetypKurzbeschreibung
clearValidation()CheckboxGridItemEntfernt alle Datenvalidierungen für dieses Rasterelement.
createResponse(responses)ItemResponseErstellt ein neues ItemResponse für dieses Kästchen als Rasterelement.
duplicate()CheckboxGridItemErstellt 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)CheckboxGridItemLegt die Spalten des Rasters anhand eines Wertearrays fest.
setHelpText(text)CheckboxGridItemLegt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).
setRequired(enabled)CheckboxGridItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setRows(rows)CheckboxGridItemLegt die Zeilen des Rasters anhand eines Arrays von Werten fest.
setTitle(title)CheckboxGridItemLegt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)
setValidation(validation)CheckboxGridItemLegt die Datenvalidierung für dieses Kästchen-Rasterelement fest.

Detaillierte Dokumentation

clearValidation()

Entfernt alle Datenvalidierungen für dieses Rasterelement.

Zurücksenden

CheckboxGridItem: 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 ein neues ItemResponse für dieses Kästchen als Rasterelement. Das Argument responses muss ein String[][]-Array mit Arrays sein, die so viele Werte wie die Anzahl der Eingaben im Kästchenraster enthalten. Ein null-Element für eine nicht erforderliche Kästchenrasterfrage gibt an, dass es keine Antwort auf diese Zeile gibt. Löst eine Ausnahme aus, wenn einer der Werte nicht mit einer gültigen Auswahl übereinstimmt.

Parameter

NameTypBeschreibung
responsesString[][]ein Array von gültigen Antworten für dieses Kästchen-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

CheckboxGridItem: ein Duplikat dieses CheckboxGridItem, 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

CheckboxGridItem: 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

CheckboxGridItem – dieser CheckboxGridItem 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

CheckboxGridItem: 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

CheckboxGridItem: 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

CheckboxGridItem – dieser CheckboxGridItem 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 Kästchen-Rasterelement fest. Wenn Sie null oder eine Validierung übergeben, ohne dass aufgerufene Funktionen erforderlich sind, wird die vorherige Validierung entfernt.

Parameter

NameTypBeschreibung
validationCheckboxGridValidationein Kästchen, das auf dieses Element angewendet werden soll.

Zurücksenden

CheckboxGridItem – dieser CheckboxGridItem 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