一种布局项,用于直观地指示某个部分的开头。您可以通过 Form 访问或创建项。
// 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');
方法
| 方法 | 返回值类型 | 简介 |
|---|---|---|
duplicate() | Section | 创建此项的副本,并将其附加到表单的末尾。 |
get | String | 获取项的帮助文本(对于 Image、Page 和 Section 等布局项,有时称为说明文本)。 |
get | Integer | 获取项的唯一标识符。 |
get | Integer | 获取项在表单中所有项中的索引。 |
get | String | 获取项的标题(对于 Section,有时称为标头文本)。 |
get | Item | 获取项的类型,以 Item 表示。 |
set | Section | 设置项的帮助文本(对于 Image、Page 和 Section 等布局项,有时称为说明文本)。 |
set | Section | 设置项的标题(对于 Section,有时称为标头文本)。 |
详细文档
duplicate()
创建此项的副本,并将其附加到表单的末尾。
返回
SectionHeaderItem - 此 SectionHeaderItem 的副本,用于链式调用
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
获取项的帮助文本(对于 ImageItems、PageBreakItems 和 SectionHeaderItems 等布局项,有时称为说明文本)。
返回
String - 项的帮助文本或说明文本
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
获取项的唯一标识符。
返回
Integer - 项的 ID
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
获取项在表单中所有项中的索引。
返回
Integer - 项的索引
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
获取项的标题(对于 SectionHeaderItem,有时称为标头文本)。
返回
String - 项的标题或标头文本
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
setHelpText(text)
设置项的帮助文本(对于 ImageItems、PageBreakItems 和 SectionHeaderItems 等布局项,有时称为说明文本)。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
text | String | 新的帮助文本 |
返回
SectionHeaderItem - 此 SectionHeaderItem,用于链式调用
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
设置项的标题(对于 SectionHeaderItem,有时称为标头文本)。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
title | String | 新标题或标头文本 |
返回
SectionHeaderItem - 此 SectionHeaderItem,用于链式调用
授权
使用此方法需要获得以下一个或多个范围的授权的脚本:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms