Diese Seite wurde von der Cloud Translation API übersetzt.

Interface Item

Ein generisches Formularelement, das Eigenschaften enthält, die für alle Elemente gelten, wie Titel und Hilfetext. Elemente können über ein Form erstellt oder aufgerufen werden.

Zur Verarbeitung typspezifischer Eigenschaften verwenden Sie getType(), um den ItemType des Elements zu prüfen, und wandeln Sie das Element dann in den Klasse mithilfe einer Methode wie asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Implementierungsklassen

Name	Kurzbeschreibung

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`asCheckboxGridItem()`	`CheckboxGridItem`	Gibt das Element als Kästchen-Rasterelement zurück.
`asCheckboxItem()`	`CheckboxItem`	Gibt das Element als Kästchenelement zurück.
`asDateItem()`	`DateItem`	Gibt das Element als Datumselement zurück.
`asDateTimeItem()`	`DateTimeItem`	Gibt das Element als Datum-Uhrzeitelement zurück.
`asDurationItem()`	`DurationItem`	Gibt das Element als Element für die Dauer zurück.
`asGridItem()`	`GridItem`	Gibt das Element als Rasterelement zurück.
`asImageItem()`	`ImageItem`	Gibt das Element als Bildelement zurück.
`asListItem()`	`ListItem`	Gibt das Element als Listenelement zurück
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Gibt das Element als Multiple-Choice-Element zurück
`asPageBreakItem()`	`PageBreakItem`	Gibt das Element als Seitenumbruchelement zurück
`asParagraphTextItem()`	`ParagraphTextItem`	Gibt das Element als Absatztextelement zurück.
`asScaleItem()`	`ScaleItem`	Gibt das Element als Skalierungselement zurück.
`asSectionHeaderItem()`	`SectionHeaderItem`	Gibt das Element als Abschnittsüberschrift zurück.
`asTextItem()`	`TextItem`	Gibt das Element als Textelement zurück
`asTimeItem()`	`TimeItem`	Gibt das Element als Zeitelement zurück
`asVideoItem()`	`VideoItem`	Gibt das Element als Videoelement zurück
`duplicate()`	`Item`	Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.
`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.
`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`.
`setHelpText(text)`	`Item`	Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`setTitle(title)`	`Item`	Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines `SectionHeaderItem`).

Detaillierte Dokumentation

`asCheckboxGridItem()`

Gibt das Element als Kästchen-Rasterelement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits CHECKBOX_GRID war.

Rückflug

CheckboxGridItem – das Kästchen-Rasterelement

Löst aus

Error – wenn das Element kein Kästchen im Raster 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

`asCheckboxItem()`

Gibt das Element als Kästchenelement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits CHECKBOX war.

Rückflug

CheckboxItem – das Kästchenelement

Löst aus

Error – wenn das Element kein Kästchen 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

`asDateItem()`

Gibt das Element als Datumselement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits DATE war.

Rückflug

DateItem – das Datum

Löst aus

Error – wenn das Element kein Datum 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

`asDateTimeItem()`

Gibt das Element als Datum-Uhrzeitelement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits DATETIME war.

Rückflug

DateTimeItem – Datum-Uhrzeitelement

Löst aus

Error – wenn das Element kein Datum-Uhrzeit-Element 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

`asDurationItem()`

Gibt das Element als Element für die Dauer zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits DURATION war.

Rückflug

DurationItem – das Element für die Dauer

Löst aus

Error – wenn das Element kein Element für die Dauer 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

`asGridItem()`

Gibt das Element als Rasterelement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits GRID war.

Rückflug

GridItem – das Rasterelement

Löst aus

Error – wenn das Element kein Rasterelement 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

`asImageItem()`

Gibt das Element als Bildelement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits IMAGE war.

Rückflug

ImageItem – das Bildelement

Löst aus

Error, wenn das Element kein Bildelement ist

`asListItem()`

Gibt das Element als Listenelement zurück Löst eine Skriptausnahme aus, wenn ItemType nicht bereits LIST war.

Rückflug

ListItem – das Listenelement

Löst aus

Error, wenn das Element kein Listenelement 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

`asMultipleChoiceItem()`

Gibt das Element als Multiple-Choice-Element zurück Löst eine Skriptausnahme aus, wenn ItemType nicht bereits MULTIPLE_CHOICE war.

Rückflug

MultipleChoiceItem (Multiple-Choice-Frage)

Löst aus

Error, wenn das Element kein Multiple-Choice-Element 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

`asPageBreakItem()`

Gibt das Element als Seitenumbruchelement zurück Löst eine Skriptausnahme aus, wenn ItemType nicht bereits PAGE_BREAK war.

Rückflug

PageBreakItem – das Element für den Seitenumbruch

Löst aus

Error, wenn das Element kein Seitenumbruchelement 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

`asParagraphTextItem()`

Gibt das Element als Absatztextelement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits PARAGRAPH_TEXT war.

Rückflug

ParagraphTextItem – das Absatztextelement

Löst aus

Error – wenn das Element kein Absatztextelement 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

`asScaleItem()`

Gibt das Element als Skalierungselement zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits SCALE war.

Rückflug

ScaleItem – das Skalierungselement

Löst aus

Error – wenn das Element kein Skalaelement 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

`asSectionHeaderItem()`

Gibt das Element als Abschnittsüberschrift zurück. Löst eine Skriptausnahme aus, wenn ItemType nicht bereits SECTION_HEADER war.

Rückflug

SectionHeaderItem – der Abschnitts-Header-Element

Löst aus

Error, wenn das Element kein Abschnittsüberschriftenelement 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

`asTextItem()`

Gibt das Element als Textelement zurück Löst eine Skriptausnahme aus, wenn ItemType nicht bereits TEXT war.

Rückflug

TextItem – das Textelement

Löst aus

Error, wenn das Element kein Textelement 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

`asTimeItem()`

Gibt das Element als Zeitelement zurück Löst eine Skriptausnahme aus, wenn ItemType nicht bereits TIME war.

Rückflug

TimeItem – das Zeitelement

Löst aus

Error – wenn es sich nicht um ein Zeitelement handelt

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

`asVideoItem()`

Gibt das Element als Videoelement zurück Löst eine Skriptausnahme aus, wenn ItemType nicht bereits VIDEO war.

Rückflug

VideoItem – das Videoelement

Löst aus

Error, wenn das Element kein Videoelement ist

`duplicate()`

Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.

Rückflug

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

`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

`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

`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

Item – diese Item, 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

Item – diese Item, 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