Um item de layout que indica visualmente o início de uma seção. Os itens podem ser acessados ou criados
com uma Form.
// Open a form by ID and add a new section header.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addSectionHeaderItem();
item.setTitle('Title of new section');
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
duplicate() | SectionHeaderItem | Cria uma cópia desse item e a anexa ao final do formulário. |
getHelpText() | String | Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems). |
getId() | Integer | Recebe o identificador exclusivo do item. |
getIndex() | Integer | Recebe o índice do item entre todos os itens do formulário. |
getTitle() | String | Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem). |
getType() | ItemType | Recebe o tipo do item, representado como um ItemType. |
setHelpText(text) | SectionHeaderItem | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems). |
setTitle(title) | SectionHeaderItem | Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem). |
Documentação detalhada
duplicate()
Cria uma cópia desse item e a anexa ao final do formulário.
Retorno
SectionHeaderItem: uma cópia deste SectionHeaderItem, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).
Retorno
String: o texto de ajuda ou de descrição do item
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Recebe o identificador exclusivo do item.
Retorno
Integer: ID do item
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Recebe o índice do item entre todos os itens do formulário.
Retorno
Integer: o índice do item
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
Retorno
String: título ou texto do cabeçalho do item.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
setHelpText(text)
Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
text | String | o novo texto de ajuda |
Retorno
SectionHeaderItem: este SectionHeaderItem, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
title | String | o novo título ou texto do cabeçalho |
Retorno
SectionHeaderItem: este SectionHeaderItem, para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms