Item de pergunta, apresentado como uma grade de colunas e linhas, que permite ao participante selecionar
várias opções por linha em uma sequência de caixas de seleção. Os itens podem ser acessados ou criados
Form
:
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
clearValidation() | CheckboxGridItem | Remove qualquer validação de dados para esse item da grade. |
createResponse(responses) | ItemResponse | Cria um novo ItemResponse para esse item de grade da caixa de seleção. |
duplicate() | CheckboxGridItem | Cria uma cópia desse item e a anexa ao final do formulário. |
getColumns() | String[] | Recebe os valores de cada coluna na grade. |
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 | Extrai o identificador exclusivo do item. |
getIndex() | Integer | Recebe o índice do item entre todos os itens do formulário. |
getRows() | String[] | Recebe os valores de cada linha na grade. |
getTitle() | String | Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem ). |
getType() | ItemType | Recebe o tipo do item, representado como ItemType . |
isRequired() | Boolean | Determina se o respondente precisa responder à pergunta. |
setColumns(columns) | CheckboxGridItem | Define as colunas da grade com base em uma matriz de valores. |
setHelpText(text) | CheckboxGridItem | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems , PageBreakItems e SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | Define se o participante precisa responder à pergunta. |
setRows(rows) | CheckboxGridItem | Define as linhas da grade com base em uma matriz de valores. |
setTitle(title) | CheckboxGridItem | Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem . |
setValidation(validation) | CheckboxGridItem | Define a validação de dados para esse item de grade da caixa de seleção. |
Documentação detalhada
clearValidation()
Remove qualquer validação de dados para esse item da grade.
Retornar
CheckboxGridItem
: este item para encadeamento.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Cria um novo ItemResponse
para esse item de grade da caixa de seleção. O argumento responses
precisa ser uma matriz String[][]
de matrizes contendo tantos valores quanto o número de entradas
na grade de caixas de seleção. Um elemento null
para uma pergunta de grade com caixas de seleção não obrigatória
indica que não há resposta para essa linha. Emite uma exceção se algum dos valores não corresponde a um
uma escolha válida.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
responses | String[][] | uma matriz de matrizes de respostas válidas para este item da grade da caixa de seleção |
Retornar
ItemResponse
: a resposta do item.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Cria uma cópia desse item e a anexa ao final do formulário.
Retornar
CheckboxGridItem
: uma cópia deste CheckboxGridItem
para encadeamento.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Recebe os valores de cada coluna na grade.
Retornar
String[]
: uma matriz de valores de coluna, que os entrevistados veem como rótulos ao visualizar o formulário
Autorização
Os scripts que usam esse método precisam de 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
).
Retornar
String
: o texto de ajuda ou de descrição do item.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Extrai o identificador exclusivo do item.
Retornar
Integer
: o código do item.
Autorização
Os scripts que usam esse método precisam de 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.
Retornar
Integer
: o índice do item.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Recebe os valores de cada linha na grade.
Retornar
String[]
: uma matriz de valores de linha, que os entrevistados veem como rótulos ao visualizar o formulário
Autorização
Os scripts que usam esse método precisam de 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 de cabeçalho, no caso de uma SectionHeaderItem
).
Retornar
String
: o título ou texto do cabeçalho do item
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
isRequired()
Determina se o respondente precisa responder à pergunta.
Retornar
Boolean
: se o participante precisa responder à pergunta.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Define as colunas da grade com base em uma matriz de valores. Gera uma exceção se o tipo matriz está vazia.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
columns | String[] | uma matriz de valores de coluna, que os entrevistados veem como rótulos ao visualizar o formulário |
Retornar
CheckboxGridItem
: este item para encadeamento.
Gera
Error
: se a matriz fornecida for null
ou estiver vazia
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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 |
Retornar
CheckboxGridItem
: este CheckboxGridItem
, para encadeamento
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Define se o participante precisa responder à pergunta.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
enabled | Boolean | se o entrevistado deve responder à pergunta |
Retornar
CheckboxGridItem
: o item atual (para encadeamento).
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Define as linhas da grade com base em uma matriz de valores. Gera uma exceção se a matriz fornecida está vazio.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
rows | String[] | uma matriz de valores de linha, que os entrevistados veem como rótulos ao visualizar o formulário |
Retornar
CheckboxGridItem
: este item para encadeamento.
Gera
Error
: se a matriz fornecida for null
ou estiver vazia
Autorização
Os scripts que usam esse método precisam de 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 de cabeçalho, no caso de uma SectionHeaderItem
.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
title | String | o novo título ou texto do cabeçalho |
Retornar
CheckboxGridItem
: este CheckboxGridItem
, para encadeamento
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Define a validação de dados para esse item de grade da caixa de seleção. Transmitir um valor nulo ou uma validação sem de qualquer função "require", chamada, removerá qualquer validação anterior.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
validation | CheckboxGridValidation | um CheckboxGridValidation para aplicar a esse item. |
Retornar
CheckboxGridItem
: este CheckboxGridItem
, para encadeamento
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms