Diese Seite wurde von der Cloud Translation API übersetzt.

Class CheckboxItem

Ein Frageelement, mit dem der Befragte ein oder mehrere Kästchen auswählen kann, sowie ein optional „Sonstiges“ ein. Elemente können über ein Form erstellt oder aufgerufen werden. Bei Verwendung in einem Quizfragen beantwortet wurden, werden diese Elemente 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ästchenelement.
`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ästchenelement.
`duplicate()`	`CheckboxItem`	Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.
`getChoices()`	`Choice[]`	Ruft alle Auswahlmöglichkeiten für ein Element ab.
`getFeedbackForCorrect()`	`QuizFeedback`	Gibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage richtig beantworten.
`getFeedbackForIncorrect()`	`QuizFeedback`	Gibt das Feedback zurück, das die Befragten sehen, wenn sie eine Frage falsch beantworten.
`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 Kennzeichnung des Artikels ab.
`getIndex()`	`Integer`	Ruft den Index des Elements unter allen Elementen im Formular ab.
`getPoints()`	`Integer`	Gibt die Punktzahl eines benoteten Elements zurück
`getTitle()`	`String`	Ruft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von `SectionHeaderItem`.
`getType()`	`ItemType`	Ruft den Typ des Elements ab, dargestellt als `ItemType`.
`hasOtherOption()`	`Boolean`	Bestimmt, ob das Element „Sonstiges“ hat Option.
`isRequired()`	`Boolean`	Bestimmt, ob der Teilnehmer die Frage beantworten muss.
`setChoiceValues(values)`	`CheckboxItem`	Legt die Auswahlmöglichkeiten 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 Befragten angezeigt wird, wenn sie eine Frage richtig beantworten.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Legt fest, dass das Feedback den Befragten angezeigt wird, wenn sie eine Frage falsch beantworten.
`setHelpText(text)`	`CheckboxItem`	Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`setPoints(points)`	`CheckboxItem`	Legt die Anzahl der Punkte fest, die ein benotetes Element wert ist.
`setRequired(enabled)`	`CheckboxItem`	Legt fest, ob der Befragte die Frage beantworten muss.
`setTitle(title)`	`CheckboxItem`	Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	Legt die Datenvalidierung für dieses Kästchenelement fest.
`showOtherOption(enabled)`	`CheckboxItem`	Legt fest, ob das Element „Sonstiges“ hat Option.

Detaillierte Dokumentation

`clearValidation()`

Entfernt alle Datenvalidierungen für dieses Kästchenelement.

Rückflug

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

Name	Typ	Beschreibung
`value`	`String`	Wert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird

Rückflug

Choice — die neue Option

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

Name	Typ	Beschreibung
`value`	`String`	Wert der Auswahl, der den Befragten beim Ansehen des Formulars als Label angezeigt wird
`isCorrect`	`Boolean`	ob die Antwort eine richtige Antwort ist,

Rückflug

Choice — die neue Option

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

Parameter

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

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

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

`getChoices()`

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

Rückflug

Choice[] – eine Reihe von 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 die Befragten sehen, wenn sie eine Frage richtig beantworten.

Rückflug

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 die Befragten sehen, wenn sie eine Frage falsch beantworten.

Rückflug

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

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

`getPoints()`

Gibt die Punktzahl eines benoteten Elements zurück

Rückflug

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

`hasOtherOption()`

Bestimmt, ob das Element „Sonstiges“ hat Option.

Rückflug

Boolean: true, wenn das Element eine andere Bezeichnung hat optional: 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()`

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

`setChoiceValues(values)`

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

// 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[]`	das Array der Auswahlwerte, das die Befragten als Beschriftungen sehen, wenn sie das Formular ansehen

Rückflug

CheckboxItem – diese 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 von Auswahlmöglichkeiten für ein Element fest. Löst eine Ausnahme aus, wenn das angegebene Array leer ist oder enthält ein null-Element.

// 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[]`	eine Reihe von Auswahlmöglichkeiten

Rückflug

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

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback zu erhalten. Bei einem Nullwert wird das Feedback gelöscht.

Rückflug

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

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

Rückflug

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

Parameter

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

Rückflug

CheckboxItem – diese 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 benotetes Element wert ist. Der Standardwert für neue Elemente ist 0.

Parameter

Name	Typ	Beschreibung
`points`	`Integer`	die Anzahl der Punkte, die eine Frage wert ist

Rückflug

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

Parameter

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

Rückflug

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

`setTitle(title)`

Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).

Parameter

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

Rückflug

CheckboxItem – diese 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. Die Übergabe von null oder einer Validierung ohne Mit aufgerufenen Funktionen werden alle vorherigen Validierungen entfernt.

Parameter

Name	Typ	Beschreibung
`validation`	`CheckboxValidation`	Eine CheckboxValidation (CheckboxValidation), die auf dieses Element angewendet wird.

Rückflug

CheckboxItem – diese 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 „Sonstiges“ hat Option. Der Standardwert für einen neuen CheckboxItem oder MultipleChoiceItem hat den Wert false.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	`true`, wenn das Element „Sonstiges“ hat optional: `false` wenn nicht

Rückflug

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