Class CheckboxItem

CheckboxItem

Ein Frageelement, mit dem der Teilnehmer ein oder mehrere Kästchen auswählen kann, sowie ein optionales Feld "Sonstiges". Elemente können über Form aufgerufen oder erstellt werden. Diese Elemente werden automatisch benotet, wenn sie in einem Quiz verwendet werden.

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
          item.createChoice('Ketchup'),
          item.createChoice('Mustard'),
          item.createChoice('Relish')
    ])
    .showOtherOption(true);

Methoden

MethodeRückgabetypKurzbeschreibung
clearValidation()CheckboxItemEntfernt alle Datenvalidierungen für dieses Kästchenelement.
createChoice(value)ChoiceErstellt eine neue Auswahl.
createChoice(value, isCorrect)ChoiceErstellt eine neue Auswahl.
createResponse(responses)ItemResponseErstellt ein neues ItemResponse-Element für dieses Kästchenelement.
duplicate()CheckboxItemErstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.
getChoices()Choice[]Ruft alle Auswahlmöglichkeiten für ein Element ab.
getFeedbackForCorrect()QuizFeedbackGibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.
getFeedbackForIncorrect()QuizFeedbackGibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
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.
getPoints()IntegerGibt die Punktzahl eines benotbaren Elements zurück.
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.
hasOtherOption()BooleanLegt fest, ob das Element über die Option „Sonstiges“ verfügt.
isRequired()BooleanLegt fest, ob der Teilnehmer die Frage beantworten muss.
setChoiceValues(values)CheckboxItemLegt die Auswahlmöglichkeiten für ein Element aus einem String-Array fest.
setChoices(choices)CheckboxItemLegt ein Array mit Auswahlmöglichkeiten für ein Element fest.
setFeedbackForCorrect(feedback)CheckboxItemLegt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.
setFeedbackForIncorrect(feedback)CheckboxItemLegt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
setHelpText(text)CheckboxItemLegt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
setPoints(points)CheckboxItemLegt die Anzahl der Punkte fest, die ein benotbares Element wert ist.
setRequired(enabled)CheckboxItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setTitle(title)CheckboxItemLegt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet.
setValidation(validation)CheckboxItemLegt die Datenvalidierung für dieses Kästchenelement fest.
showOtherOption(enabled)CheckboxItemLegt fest, ob das Element die Option „Sonstiges“ hat.

Detaillierte Dokumentation

clearValidation()

Entfernt alle Datenvalidierungen für dieses Kästchenelement.

Return

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

createChoice(value)

Erstellt eine neue Auswahl.

Parameter

NameTypBeschreibung
valueStringden Wert der Auswahl, den die Befragten als Label sehen, wenn sie das Formular aufrufen

Return

Choice – die neue Auswahlmöglichkeit

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

createChoice(value, isCorrect)

Erstellt eine neue Auswahl.

Parameter

NameTypBeschreibung
valueStringden Wert der Auswahl, den die Befragten als Label sehen, wenn sie das Formular aufrufen
isCorrectBooleanob die Antwort richtig ist

Return

Choice – die neue Auswahlmöglichkeit

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ästchenelement. Das Argument responses ist ein String[]-Array mit Werten, die geprüft werden müssen. Löst eine Ausnahme aus, wenn ein Wert mit keiner gültigen Auswahl für dieses Element übereinstimmt, es sei denn, showOtherOption(enabled) ist auf true gesetzt.

Parameter

NameTypBeschreibung
responsesString[]Array mit gültigen Antworten für dieses Multiple-Choice-Element

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

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

getChoices()

Ruft alle Auswahlmöglichkeiten für ein Element ab.

Return

Choice[] – ein Array mit Auswahlmöglichkeiten

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

getFeedbackForCorrect()

Gibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.

Return

QuizFeedback: das Feedback, falls vorhanden.

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

getFeedbackForIncorrect()

Gibt das Feedback zurück, das den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.

Return

QuizFeedback: das Feedback, falls vorhanden.

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

getPoints()

Gibt die Punktzahl eines benotbaren Elements zurück.

Return

Integer: die Anzahl der Punkte, die eine Frage wert 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

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

hasOtherOption()

Legt fest, ob das Element über die Option „Sonstiges“ verfügt.

Return

Boolean: true, wenn das Element eine andere Option hat; false, wenn nicht

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

setChoiceValues(values)

Legt die Auswahlmöglichkeiten für ein Element aus einem String-Array fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parameter

NameTypBeschreibung
valuesString[]Array der Auswahlwerte, die die Befragten beim Aufrufen des Formulars als Labels sehen

Return

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

setChoices(choices)

Legt ein Array mit Auswahlmöglichkeiten für ein Element fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist oder ein null-Element enthält.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parameter

NameTypBeschreibung
choicesChoice[]ein Array mit Auswahlmöglichkeiten

Return

CheckboxItem – dieses CheckboxItem für Verkettung

Löst aus

Error – wenn das angegebene Array null ist, leer ist oder ein null-Element enthält

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

setFeedbackForCorrect(feedback)

Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parameter

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback. Bei einem Nullwert wird das Feedback gelöscht.

Return

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

setFeedbackForIncorrect(feedback)

Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.

Parameter

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback

Return

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

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

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

setPoints(points)

Legt die Anzahl der Punkte fest, die ein benotbares Element wert ist. Der Standardwert für neue Elemente ist 0.

Parameter

NameTypBeschreibung
pointsIntegerdie Anzahl der Punkte, die eine Frage wert ist

Return

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

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

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

CheckboxItem – dieses CheckboxItem 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ästchenelement fest. Wenn null oder eine Validierung ohne aufgerufene Anforderungsfunktionen übergeben wird, wird jede vorherige Validierung entfernt.

Parameter

NameTypBeschreibung
validationCheckboxValidationeine Kästchenvalidierung, die auf dieses Element angewendet werden soll.

Return

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

showOtherOption(enabled)

Legt fest, ob das Element die Option „Sonstiges“ hat. Der Standardwert für einen neuen CheckboxItem oder MultipleChoiceItem ist false.

Parameter

NameTypBeschreibung
enabledBooleantrue, wenn das Element die Option „Sonstiges“ hat; false, wenn nicht

Return

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