Class SectionHeaderItem

Section Header Item

A layout item that visually indicates the start of a section. Items can be accessed or created from a 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' 
 ); 

Methods

Method Return type Brief description
Section Header Item Creates a copy of this item and appends it to the end of the form.
String Gets the item's help text (sometimes called description text for layout items like Image Items , Page Break Items , and Section Header Items ).
Integer Gets the item's unique identifier.
Integer Gets the index of the item among all the items in the form.
String Gets the item's title (sometimes called header text, in the case of a Section Header Item ).
Item Type Gets the item's type, represented as an Item Type .
Section Header Item Sets the item's help text (sometimes called description text for layout items like Image Items , Page Break Items , and Section Header Items ).
Section Header Item Sets the item's title (sometimes called header text, in the case of a Section Header Item ).

Detailed documentation

duplicate()

Creates a copy of this item and appends it to the end of the form.

Return

Section Header Item — a duplicate of this Section Header Item , for chaining

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Help Text()

Gets the item's help text (sometimes called description text for layout items like Image Items , Page Break Items , and Section Header Items ).

Return

String — the item's help text or description text

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Id()

Gets the item's unique identifier.

Return

Integer — the item's ID

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Index()

Gets the index of the item among all the items in the form.

Return

Integer — the index of the item

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Title()

Gets the item's title (sometimes called header text, in the case of a Section Header Item ).

Return

String — the item's title or header text

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

get Type()

Gets the item's type, represented as an Item Type .

Return

Item Type — the item's type

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Help Text(text)

Sets the item's help text (sometimes called description text for layout items like Image Items , Page Break Items , and Section Header Items ).

Parameters

Name Type Description
text
String the new help text

Return

Section Header Item — this Section Header Item , for chaining

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

set Title(title)

Sets the item's title (sometimes called header text, in the case of a Section Header Item ).

Parameters

Name Type Description
title
String the new title or header text

Return

Section Header Item — this Section Header Item , for chaining

Authorization

Scripts that use this method require authorization with one or more of the following scopes :

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms
Create a Mobile Website
View Site in Mobile | Classic
Share by: