Class CheckboxGridItem

CheckboxGridItem

Ein Frageelement, das als Raster aus Spalten und Zeilen dargestellt wird und es dem Teilnehmer ermöglicht, aus einer Reihe von Kästchen mehrere Auswahlmöglichkeiten pro Zeile auszuwählen. Elemente können über eine 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-Element für dieses Kästchen-Rasterelement.
duplicate()CheckboxGridItemErstellt 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)CheckboxGridItemLegt die Spalten des Rasters auf der Grundlage eines Arrays von Werten fest.
setHelpText(text)CheckboxGridItemLegt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
setRequired(enabled)CheckboxGridItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setRows(rows)CheckboxGridItemLegt die Zeilen des Rasters auf der Grundlage eines Arrays von Werten fest.
setTitle(title)CheckboxGridItemLegt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet.
setValidation(validation)CheckboxGridItemLegt die Datenvalidierung für dieses Kästchen-Rasterelement fest.

Detaillierte Dokumentation

clearValidation()

Entfernt alle Datenvalidierungen für dieses Rasterelement.

Return

CheckboxGridItem: 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 Kästchen-Rasterelement. Das Argument responses muss ein String[][]-Array von 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 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 mit gültigen Antworten für dieses Kästchen-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

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

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

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

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

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

CheckboxGridItem – dieses CheckboxGridItem 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 Kästchen-Rasterelement fest. Wenn null oder eine Validierung ohne aufgerufene erforderliche Funktionen übergeben wird, wird jede vorherige Validierung entfernt.

Parameter

NameTypBeschreibung
validationCheckboxGridValidationeine CheckboxGridValidation, die auf dieses Element angewendet werden soll.

Return

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