Diese Seite wurde von der Cloud Translation API übersetzt.

Class CheckboxItem

Ein Fragenelement, mit dem der Teilnehmer ein oder mehrere Kästchen auswählen kann, sowie ein optionales Feld „Sonstiges“. Elemente können über ein Form aufgerufen oder erstellt werden. Wenn Sie sie in einem Quiz verwenden, werden sie automatisch benotet.

// 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

Methode	Rückgabetyp	Kurzbeschreibung
`clearValidation()`	`CheckboxItem`	Entfernt alle Datenvalidierungen für dieses Kästchen.
`createChoice(value)`	`Choice`	Erstellt eine neue Auswahl.
`createChoice(value, isCorrect)`	`Choice`	Erstellt eine neue Auswahl.
`createResponse(responses)`	`ItemResponse`	Erstellt eine neue `ItemResponse` für dieses Kästchen.
`duplicate()`	`CheckboxItem`	Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
`getChoices()`	`Choice[]`	Ruft alle Optionen für ein Element ab.
`getFeedbackForCorrect()`	`QuizFeedback`	Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine Frage richtig beantworten.
`getFeedbackForIncorrect()`	`QuizFeedback`	Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie falsch auf eine Frage antworten.
`getHelpText()`	`String`	Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet.
`getId()`	`Integer`	Ruft die eindeutige Kennung des Elements ab.
`getIndex()`	`Integer`	Ruft den Index des Elements aus allen Elementen im Formular ab.
`getPoints()`	`Integer`	Gibt die Punktzahl eines benotebaren Elements zurück.
`getTitle()`	`String`	Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls `SectionHeaderItem`.
`getType()`	`ItemType`	Ruft den Elementtyp ab, dargestellt als `ItemType`.
`hasOtherOption()`	`Boolean`	Legt fest, ob das Element die Option „Sonstiges“ hat.
`isRequired()`	`Boolean`	Legt fest, ob der Teilnehmer die Frage beantworten muss.
`setChoiceValues(values)`	`CheckboxItem`	Legt die Auswahl für ein Element aus einem String-Array fest.
`setChoices(choices)`	`CheckboxItem`	Legt ein Array von Auswahlmöglichkeiten für ein Element fest.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Legt fest, dass das Feedback den Teilnehmern angezeigt werden soll, wenn sie eine Frage richtig beantworten.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Sie können festlegen, dass Feedback den Teilnehmern angezeigt werden soll, wenn sie falsch auf eine Frage antworten.
`setHelpText(text)`	`CheckboxItem`	Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems`).
`setPoints(points)`	`CheckboxItem`	Legt die Anzahl der Punkte fest, die ein Element in einer Benotung wert ist.
`setRequired(enabled)`	`CheckboxItem`	Legt fest, ob der Teilnehmer die Frage beantworten muss.
`setTitle(title)`	`CheckboxItem`	Legt den Titel des Elements fest (manchmal auch Headertext bei `SectionHeaderItem`)
`setValidation(validation)`	`CheckboxItem`	Legt die Datenvalidierung für dieses Kästchenelement fest.
`showOtherOption(enabled)`	`CheckboxItem`	Legt fest, ob das Element die Option „Sonstiges“ hat.

Detaillierte Dokumentation

`clearValidation()`

Entfernt alle Datenvalidierungen für dieses Kästchen.

Zurücksenden

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

`createChoice(value)`

Erstellt eine neue Auswahl.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen

Zurücksenden

Choice — die neue Wahl

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

`createChoice(value, isCorrect)`

Erstellt eine neue Auswahl.

Parameter

Name	Typ	Beschreibung
`value`	`String`	Der Wert der Auswahl, den Teilnehmer beim Ansehen des Formulars als Label sehen
`isCorrect`	`Boolean`	ob die richtige Antwort

Zurücksenden

Choice — die neue Wahl

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

Parameter

Name	Typ	Beschreibung
`responses`	`String[]`	Array mit gültigen Antworten für dieses Multiple-Choice-Element

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

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

`getChoices()`

Ruft alle Optionen für ein Element ab.

Zurücksenden

Choice[]: ein Array von Auswahlmöglichkeiten

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

`getFeedbackForCorrect()`

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

Zurücksenden

QuizFeedback: Das Feedback, falls vorhanden.

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

`getFeedbackForIncorrect()`

Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie falsch auf eine Frage antworten.

Zurücksenden

QuizFeedback: Das Feedback, falls vorhanden.

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

`getPoints()`

Gibt die Punktzahl eines benotebaren Elements zurück.

Zurücksenden

Integer: Gibt an, wie viele Punkte eine Frage hat.

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

`hasOtherOption()`

Legt fest, ob das Element die Option „Sonstiges“ hat.

Zurücksenden

Boolean: true, wenn das Element die Option „Sonstiges“ hat; false, wenn nicht

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

`setChoiceValues(values)`

Legt die Auswahl 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

Name	Typ	Beschreibung
`values`	`String[]`	Array mit Auswahlwerten, die den Umfrageteilnehmern beim Ansehen des Formulars als Labels angezeigt werden

Zurücksenden

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

`setChoices(choices)`

Legt ein Array von 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

Name	Typ	Beschreibung
`choices`	`Choice[]`	ein Array von Auswahlmöglichkeiten

Zurücksenden

CheckboxItem – dieser CheckboxItem für Verkettung

Throws

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

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

`setFeedbackForCorrect(feedback)`

Legt fest, dass das Feedback den Teilnehmern angezeigt werden soll, 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

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback. Bei einem Wert von null wird das Feedback gelöscht.

Zurücksenden

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

`setFeedbackForIncorrect(feedback)`

Sie können festlegen, dass Feedback den Teilnehmern angezeigt werden soll, wenn sie falsch auf eine Frage antworten.

Parameter

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback

Zurücksenden

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

`setHelpText(text)`

Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).

Parameter

Name	Typ	Beschreibung
`text`	`String`	den neuen Hilfetext

Zurücksenden

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

`setPoints(points)`

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

Parameter

Name	Typ	Beschreibung
`points`	`Integer`	die Anzahl der Punkte, die ein Frageartikel wert ist

Zurücksenden

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

Name	Typ	Beschreibung
`enabled`	`Boolean`	ob der Teilnehmer die Frage beantworten muss

Zurücksenden

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

`setTitle(title)`

Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)

Parameter

Name	Typ	Beschreibung
`title`	`String`	den neuen Titel oder Titel

Zurücksenden

CheckboxItem – dieser CheckboxItem 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ästchenelement fest. Wenn Sie null oder eine Validierung übergeben, ohne dass aufgerufene Funktionen erforderlich zu sein, wird jede vorherige Validierung entfernt.

Parameter

Name	Typ	Beschreibung
`validation`	`CheckboxValidation`	Eine Kästchenprüfung, die auf dieses Element angewendet werden soll.

Zurücksenden

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

`showOtherOption(enabled)`

Legt fest, ob das Element die Option „Sonstiges“ hat. Die Standardeinstellung für eine neue CheckboxItem oder MultipleChoiceItem ist false.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	`true`, wenn der Artikel die Option „Sonstiges“ hat; `false`, wenn nicht

Zurücksenden

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