Class CheckboxGridItem

KästchenRasterElement

Ein Frageelement, das als Raster aus Spalten und Zeilen dargestellt wird und es den Befragten ermöglicht, aus einer Reihe von Kästchen mehrere Optionen pro Zeile auszuwählen. Auf Elemente kann über eine Form zugegriffen oder sie können dort erstellt werden. 

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 die Datenvalidierung für dieses Rasterelement.
createResponse(responses)ItemResponseErstellt ein neues ItemResponse für dieses Kästchenrasterelement.
duplicate()CheckboxGridItemErstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
getColumns()String[]Hiermit werden die Werte für jede Spalte im Raster abgerufen.
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerDie eindeutige Kennung des Artikels.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getRows()String[]Hiermit werden die Werte für jede Zeile im Raster abgerufen.
getTitle()StringDer Titel des Artikels (im Fall einer SectionHeaderItem auch als Headertext bezeichnet).
getType()ItemTypeDer Typ des Artikels, dargestellt als ItemType.
isRequired()BooleanBestimmt, ob die Befragten die Frage beantworten müssen.
setColumns(columns)CheckboxGridItemLegt die Spalten des Rasters anhand eines Arrays von Werten fest.
setHelpText(text)CheckboxGridItemHiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).
setRequired(enabled)CheckboxGridItemHier legen Sie fest, ob die Befragten die Frage beantworten müssen.
setRows(rows)CheckboxGridItemLegt die Zeilen des Rasters anhand eines Wertearrays fest.
setTitle(title)CheckboxGridItemHiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).
setValidation(validation)CheckboxGridItemLegt die Datenvalidierung für dieses Kästchenrasterelement fest.

Detaillierte Dokumentation

clearValidation()

Entfernt die Datenvalidierung für dieses Rasterelement.

Rückflug

CheckboxGridItem – dieses Element, zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

createResponse(responses)

Erstellt ein neues ItemResponse für dieses Kästchenrasterelement. Das Argument responses muss ein String[][]-Array von Arrays sein, das so viele Werte wie die Anzahl der Eingaben im Kästchenraster enthält. Ein null-Element für eine optionale Frage mit Kästchenraster 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 von Arrays gültiger Antworten für dieses Kästchenrasterelement

Rückflug

ItemResponse – die Artikelantwort

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • 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

CheckboxGridItem – Duplikat dieses CheckboxGridItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getColumns()

Hiermit werden die Werte für jede Spalte im Raster abgerufen.

Rückflug

String[]: ein Array von Spaltenwerten, die den Teilnehmern im Formular als Labels angezeigt werden

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Rückflug

String: Hilfetext oder Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getId()

Die eindeutige Kennung des Artikels.

Rückflug

Integer: die Artikel-ID

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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: der Index des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getRows()

Hiermit werden die Werte für jede Zeile im Raster abgerufen.

Rückflug

String[]: ein Array von Zeilenwerten, die den Teilnehmern im Formular als Labels angezeigt werden

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getTitle()

Der Titel des Artikels (im Fall einer SectionHeaderItem auch als Headertext bezeichnet).

Rückflug

String – Titel oder Headertext des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getType()

Der Typ des Artikels, dargestellt als ItemType.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

isRequired()

Bestimmt, ob die Befragten die Frage beantworten müssen.

Rückflug

Boolean – ob die Befragten die Frage beantworten müssen

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setColumns(columns)

Legt die Spalten des Rasters anhand eines Arrays von Werten fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.

Parameter

NameTypBeschreibung
columnsString[]ein Array von Spaltenwerten, die den Teilnehmern im Formular als Labels angezeigt werden

Rückflug

CheckboxGridItem – dieses Element, zur Verkettung

Löst aus

Error – wenn das angegebene Array null oder leer ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setHelpText(text)

Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).

Parameter

NameTypBeschreibung
textStringden neuen Hilfetext

Rückflug

CheckboxGridItem – dieses CheckboxGridItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setRequired(enabled)

Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.

Parameter

NameTypBeschreibung
enabledBooleanob die Befragten die Frage beantworten müssen

Rückflug

CheckboxGridItem – das aktuelle Element (für die Verkettung)

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • 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 Teilnehmern im Formular als Labels angezeigt werden

Rückflug

CheckboxGridItem – dieses Element, zur Verkettung

Löst aus

Error – wenn das angegebene Array null oder leer ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setTitle(title)

Hiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

CheckboxGridItem – dieses CheckboxGridItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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ästchenrasterelement fest. Wenn Sie „null“ oder eine Validierung ohne Aufrufe von erforderlichen Funktionen übergeben, wird jede vorherige Validierung entfernt.

Parameter

NameTypBeschreibung
validationCheckboxGridValidationeine CheckboxGridValidation, die auf diesen Artikel angewendet werden soll.

Rückflug

CheckboxGridItem – dieses CheckboxGridItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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