Class CheckboxGridItem

CheckboxGridItem

Eine Frage, die als Raster aus Spalten und Zeilen dargestellt wird und den Befragten die Möglichkeit gibt, mehrere Auswahlmöglichkeiten pro Zeile aus einer Reihe von Kontrollkästchen. Elemente können über eine Form 

// Open a form by ID and add a new checkbox 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 eine neue ItemResponse für dieses Kästchen-Rasterelement.
duplicate()CheckboxGridItemErstellt eine Kopie dieses Elements und hängt sie am 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 Kennzeichnung des Artikels 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. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem.
getType()ItemTypeRuft den Typ des Elements ab, dargestellt als ItemType.
isRequired()BooleanBestimmt, ob der Teilnehmer die Frage beantworten muss.
setColumns(columns)CheckboxGridItemLegt die Spalten des Rasters basierend auf einem Array von Werten fest.
setHelpText(text)CheckboxGridItemLegt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setRequired(enabled)CheckboxGridItemLegt fest, ob der Befragte die Frage beantworten muss.
setRows(rows)CheckboxGridItemLegt die Zeilen des Rasters basierend auf einem Array von Werten fest.
setTitle(title)CheckboxGridItemLegt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).
setValidation(validation)CheckboxGridItemLegt die Datenvalidierung für dieses Kästchen-Rasterelement fest.

Detaillierte Dokumentation

clearValidation()

Entfernt alle Datenvalidierungen für dieses Rasterelement.

Rückflug

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

createResponse(responses)

Erstellt eine neue ItemResponse 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 enthalten im Kästchenraster. Ein null-Element für eine nicht erforderliche Ankreuz-Rasterfrage zeigt keine Antwort auf diese Zeile an. Löst eine Ausnahme aus, wenn einer der Werte keinem gültige Auswahl.

Parameter

NameTypBeschreibung
responsesString[][]Ein Array von Arrays gültiger Antworten für dieses Kästchen-Rasterelement

Rückflug

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

Rückflug

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

getColumns()

Ruft die Werte für jede Spalte im Raster ab.

Rückflug

String[]: ein Array von Spaltenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

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

Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.

Rückflug

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

Rückflug

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

Rückflug

Integer – 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.

Rückflug

String[]: ein Array von Zeilenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

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. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem.

Rückflug

String: Titel oder Text der Überschrift 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.

Rückflug

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

Bestimmt, ob der Teilnehmer die Frage beantworten muss.

Rückflug

Boolean – 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 basierend auf einem Array von Werten fest. Löst eine Ausnahme aus, wenn die angegebene Das Array ist leer.

Parameter

NameTypBeschreibung
columnsString[]Eine Reihe von Spaltenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

Rückflug

CheckboxGridItem – dieses Element zur 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 (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

NameTypBeschreibung
textStringden neuen Hilfetext

Rückflug

CheckboxGridItem – diese 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 Befragte die Frage beantworten muss.

Parameter

NameTypBeschreibung
enabledBooleanob der Befragte die Frage beantworten muss.

Rückflug

CheckboxGridItem – das aktuelle 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

setRows(rows)

Legt die Zeilen des Rasters basierend auf einem Array von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array ist leer.

Parameter

NameTypBeschreibung
rowsString[]Array von Zeilenwerten, die den Befragten beim Anzeigen des Formulars als Beschriftungen angezeigt werden

Rückflug

CheckboxGridItem – dieses Element zur 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 (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Überschriftentext

Rückflug

CheckboxGridItem – diese 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. Die Übergabe von null oder einer Validierung ohne Alle aufgerufenen erforderlichen Funktionen entfernen alle vorherigen Validierungen.

Parameter

NameTypBeschreibung
validationCheckboxGridValidationeine CheckboxGridValidation, die auf dieses Element angewendet wird.

Rückflug

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