Ein Layoutelement, das den Beginn eines Abschnitts visuell kennzeichnet. Auf Elemente kann über eine Form zugegriffen oder sie können darüber erstellt werden.
// Open a form by ID and add a new section header. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addSectionHeaderItem(); item.setTitle('Title of new section');
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
duplicate() | Section | Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein. |
get | String | Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie Image, Page und Section bezeichnet). |
get | Integer | Ruft die eindeutige Kennung des Elements ab. |
get | Integer | Ruft den Index des Elements unter allen Elementen im Formular ab. |
get | String | Ruft den Titel des Elements ab (bei einem Section manchmal auch als Header-Text bezeichnet). |
get | Item | Ruft den Typ des Elements als Item ab. |
set | Section | Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie Image, Page und Section bezeichnet). |
set | Section | Legt den Titel des Elements fest (bei einem Section manchmal auch als Überschrift bezeichnet). |
Detaillierte Dokumentation
duplicate()
Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
Rückflug
SectionHeaderItem – ein Duplikat dieses SectionHeaderItem zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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 Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
Rückflug
String – der Hilfetext oder die Beschreibung des Artikels
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Rückflug
Integer: die ID des Artikels
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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 Elements
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Header-Text bezeichnet).
Rückflug
String – der Titel oder Headertext des Elements
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Ruft den Typ des Elements als ItemType ab.
Rückflug
ItemType: Der Typ des Artikels.
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | der neue Hilfetext |
Rückflug
SectionHeaderItem – diese SectionHeaderItem zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | den neuen Titel oder Headertext |
Rückflug
SectionHeaderItem – diese SectionHeaderItem zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms